# Transit Swap Cross

> chains supported (fromChainID & toChainID):

* Ethereum: 1
* BSC: 56
* OkExchain: 66
* HECO: 128
* Matic: 137
* Fantom: 250
* KCC: 321
* AVAX: 43114
* TRON: 95500

> bridge supported:

* ANYSWAP
* METAPATH
* CBRIDGE

## Tokens API

## Cross Tokens List

<mark style="color:blue;">`GET`</mark> `https://aggserver.transit.finance/v3/cross/common/list`

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "result": 0,
    "message": "success",
    "data": {
        "bridgers": [
            "ISWAP",
            "METAPATH"
        ],
        "chains": {
            "ISWAP":[],
            "METAPATH":[]
        },
        "tokens":{
            "ISWAP":[],
            "METAPATH":[]
        }
    }
}
```

{% endtab %}
{% endtabs %}

## Swap API

## Transit Swap API for Cross

<mark style="color:blue;">`GET`</mark> `https://aggserver.transit.finance/v3/cross/swap`

#### Query Parameters

| Name                                          | Type    | Description                                 |
| --------------------------------------------- | ------- | ------------------------------------------- |
| toChainID<mark style="color:red;">\*</mark>   | integer | chainID for cross to chain                  |
| decimal0                                      | integer | Decimals of the token0                      |
| token0<mark style="color:red;">\*</mark>      | string  | Contract address of a token on fromChain    |
| fromChainID<mark style="color:red;">\*</mark> | integer | chainID for cross from chain                |
| to                                            | string  | Recipient token1 on toChain                 |
| amountIn                                      | integer | Amount of a token to cross swap             |
| bridge<mark style="color:red;">\*</mark>      | string  | Use bridge of cross                         |
| token1<mark style="color:red;">\*</mark>      | string  | Contract address of a token on toChain      |
| decimal1                                      | integer | Decimals of the token1                      |
| channel                                       | string  | "default"、"web"、"android"、"ios"、"extension" |
| issuer                                        | string  | Sender of transaction push                  |

{% tabs %}
{% tab title="200: OK cross-chain swap data for EVM" %}

```javascript
{
    "result": 0,
    "message": "success",
    "data": {
        "token0": "",
        "token1": "",
        "chainID": "",
        "destChainID": "",
        "amountIn": "",
        "to": "",
        "price": ,
        "fee": "",
        "relayerFee":"",
        "feeRate": "",
        "amountOut": "",
        "crossPool": "",
        "router": "",
        "exchange": "",
        "data": ""
    }
    
}
```

{% endtab %}

{% tab title="200: OK cross-chain swap data for TRON Format" %}

```javascript
{
    "result": 0,
    "message": "success",
    "data": {
        "token0": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "token1": "0x55d398326f99059ff775485246999027b3197955",
        "chainID": "95500",
        "destChainID": "56",
        "amountIn": "31000000",
        "to": "",
        "price": "-",
        "fee": "0.44252000",
        "relayerFee":"",
        "feeRate": "-",
        "amountOut": "30557480427023319814",
        "crossPool": "-",
        "router": "TFHc9qsQCiepyyUQynnVVrQwMxZ37Fi15N",
        "exchange": "iswap",
        "data": {
            "contract": "TFHc9qsQCiepyyUQynnVVrQwMxZ37Fi15N",
            "fun": "otherswap(uint256,(address,address,address,uint256,uint256,uint256,bool,string,uint256),bytes)",
            "options": {
                "callValue": "0",
                "feeLimit": 100000000
            },
            "parameter": [
                {
                    "type": "uint256",
                    "value": "1"
                },
                {
                    "type": "tuple(address,address,address,uint256,uint256,uint256,bool,string,uint256)",
                    "value": [
                        "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
                        "0x55d398326f99059ff775485246999027b3197955",
                        "",
                        "31000000",
                        1,
                        4,
                        true,
                        "ios",
                        "56"
                    ]
                },
                {
                    "type": "bytes",
                    "value": "0x00...00"
                }
            ],
            "issuer": ""
        }
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Responses Details
{% endhint %}

* amountOut: cross-swap amountOut on toChain for token1
* router: Transit swap Router v3
* exchange: use bridge （anySwap or MetaPath)
* data: ABI data can be sent directly to router contract
* about 'relayerFee': if exchange is MetaPath, it'll be the number of token1

## Cross Order Callback API

If use 'MetaPath' to cross swap, it's better to request this api to speed up transactions.

## Order Callback

<mark style="color:blue;">`GET`</mark> `https://aggserver.transit.finance/v3/cross/order`

#### Query Parameters

| Name                                           | Type   | Description                                 |
| ---------------------------------------------- | ------ | ------------------------------------------- |
| bridge<mark style="color:red;">\*</mark>       | String |                                             |
| fromChainID<mark style="color:red;">\*</mark>  | String |                                             |
| toChainID<mark style="color:red;">\*</mark>    | String |                                             |
| token0<mark style="color:red;">\*</mark>       | String |                                             |
| token1<mark style="color:red;">\*</mark>       | String |                                             |
| to<mark style="color:red;">\*</mark>           | String |                                             |
| amountIn<mark style="color:red;">\*</mark>     | String |                                             |
| channel<mark style="color:red;">\*</mark>      | String |                                             |
| hash<mark style="color:red;">\*</mark>         | String | the hash of from chain's transaction        |
| amountOutMin<mark style="color:red;">\*</mark> | String | use the result data 'amountOut' of swap api |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "result": 0,
    "message": "success",
    "data": "" //order id
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.transit.finance/reference/api-reference/transit-swap-cross.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.