# Allbridge Core

### Supported Chains

Available on **Ethereum, Arbitrum, Avalanche, Base, Optimism, Binance Smart Chain, Tron, Polygon, Solana, Sui and Stellar**

### Available Endpoints:

*Click on the endpoint to jump to the section with full details*

* [**/**<mark style="color:blue;">**getprice**</mark>](#getprice) <mark style="color:blue;">`GET`</mark> - Returns the swap quotation for a given token pair.
* [<mark style="color:blue;">**/**</mark>](#getuserliquidity)[<mark style="color:blue;">**getsupportedchains**</mark><mark style="color:blue;">`GET`</mark>](#getsupportedchains) - Retrieves the list of chains supported by Allbridge Core , on expand.network.
* [**/**](#getpoolliquidity)[<mark style="color:blue;">**getsupportedtokens**</mark><mark style="color:blue;">`GET`</mark>](#getsupportedtokens) - Retrieves the list of tokens supported by Allbridge Core, on expand.network.
* [**/**](#gettokenliquidity)[<mark style="color:blue;">**gettransaction**</mark>](#gettransaction) <mark style="color:blue;">`GET`</mark> - Retrieves the details of the transaction.
* [**/**<mark style="color:blue;">**swap**</mark>](#swap) <mark style="color:green;">`POST`</mark> - Initiates a transaction to swap assets accross multiple chains.

### Bridge ID

Many endpoints have a parameter where you can provide a Bridge ID.&#x20;

Below is a list of Bridge ID related to Allbridge Core. Please see the [Bridge ID Page](https://docs.expand.network/ids/bridge-ids) for a complete Bridge ID list and more information.

| Bridge Name    | Bridge ID |
| -------------- | --------- |
| Allbridge Core | 400       |

## Endpoint Details

### /getsupportedchains

Get the list of chains supported by Squid Router, on expand.network.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/bridge/getsupportedchains`

#### Query Parameters

| Name                                       | Type   | Description                                                                            |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------------------- |
| bridgeId<mark style="color:red;">\*</mark> | String | Refer to the [Bridge ID](https://docs.expand.network/ids/bridge-ids) page for details. |
| rpc                                        | String | Remote procedural call URL.                                                            |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/bridge/getsupportedchains?bridgeId=400
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": [
        {
            "chainName": "Ethereum",
            "chainId": "1",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Optimism",
            "chainId": "10",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Binance Smart Chain",
            "chainId": "56",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Sui",
            "chainId": "101",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Polygon",
            "chainId": "137",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Solana",
            "chainId": "900",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Tron",
            "chainId": "1000",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Stellar",
            "chainId": "1500",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Base",
            "chainId": "8453",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Arbitrum One",
            "chainId": "42161",
            "srcChainSupported": true,
            "dstChainSupported": true
        },
        {
            "chainName": "Celo",
            "chainId": "42220",
            "srcChainSupported": false,
            "dstChainSupported": true
        },
        {
            "chainName": "Avalanche C-Chain",
            "chainId": "43114",
            "srcChainSupported": true,
            "dstChainSupported": true
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### /getsupportedtokens

Get the list of tokens supported by Squid Router, on the specified chain, on expand.network.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/bridge/getsupportedtokens`

#### Query Parameters

| Name                                       | Type   | Description                                                                                                          |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------- |
| bridgeId<mark style="color:red;">\*</mark> | String | Refer to the [Bridge ID](https://docs.expand.network/ids/bridge-ids) page for details.                               |
| rpc                                        | String | Remote procedural call URL.                                                                                          |
| chainId<mark style="color:red;">\*</mark>  | String | Refer to the [Chain ID](https://docs.expand.network/ids/bridge-ids/internal-chain-ids-for-bridges) page for details. |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/bridge/getsupportedtokens?bridgeId=400&chainId=1
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": [
        {
            "tokenSymbol": "USDC",
            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        {
            "tokenSymbol": "USDT",
            "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### /getprice

Get the swap quotation for the given token pairs.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/bridge/getprice`

#### Query Parameter

| Name                                             | Type   | Description                                                                                                                                                        |
| ------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| rpc                                              | String | Remote procedural call URL.                                                                                                                                        |
| bridgeId<mark style="color:red;">\*</mark>       | String | Refer to the [Bridge ID](https://docs.expand.network/important-ids/bridge-id) page for details.                                                                    |
| srcChainId                                       | String | <p><a href="https://docs.expand.network/important-ids/bridge-id/internal-chain-ids-for-bridge">Chain Id</a> of the source chain.<br>By default, Ethereum chain</p> |
| dstChainId<mark style="color:red;">\*</mark>     | String | [Chain Id](https://docs.expand.network/important-ids/bridge-id/internal-chain-ids-for-bridge) of the destination chain.                                            |
| srcTokenSymbol<mark style="color:red;">\*</mark> | String | Source token symbol.                                                                                                                                               |
| dstTokenSymbol<mark style="color:red;">\*</mark> | String | Destination token symbol.                                                                                                                                          |
| amountIn<mark style="color:red;">\*</mark>       | String | Amount of token.                                                                                                                                                   |

{% tabs %}
{% tab title="Sample Response" %}

```url
https://api.expand.network/bridge/getprice?amountIn=1000000&srcChainId=900&dstChainId=900&srcTokenSymbol=usdc&dstTokenSymbol=usdt&bridgeId=400
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "srcChainId": "900",
        "dstChainId": "900",
        "srcTokenSymbol": "usdc",
        "dstTokenSymbol": "usdt",
        "amountIn": "1000000",
        "amountsOut": [
            "1000000",
            "994506"
        ]
    }
}
```

{% endtab %}
{% endtabs %}

### /gettransaction

Retrieves the details of the transaction.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/bridge/gettransaction`

#### Query Parameter

| Name                                              | Type   | Description                                                                                                                                                                                        |
| ------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| rpc                                               | String | Remote procedural call URL.                                                                                                                                                                        |
| bridgeId<mark style="color:red;">\*</mark>        | String | Refer to the [Bridge ID](https://docs.expand.network/important-ids/bridge-id) page for details.                                                                                                    |
| transactionHash<mark style="color:red;">\*</mark> | String | Transaction hash.                                                                                                                                                                                  |
| srcChainId                                        | String | <p> <a href="https://docs.expand.network/important-ids/bridge-id/internal-chain-ids-for-bridge">Chain Id</a> of the source chain.<br>If txn involve Stellar, use Stellar chainId as srcChainId</p> |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/bridge/gettransaction?bridgeId=400&srcChainId=900&transactionHash=3uTxUbsYbXYL6xNjdxZZaqt7R69ZzgEPDZzVF5JG8pnM8AxJhVJAUEfE5eysEJvfJsGpbfuzoYE6z286KWZ2wTaf
```

{% endtab %}

{% tab title="Sample Response" %}

```
{
    "status": 200,
    "msg": "success",
    "data": {
        "status": "EXECUTED",
        "srcTx": {
            "hash": "3uTxUbsYbXYL6xNjdxZZaqt7R69ZzgEPDZzVF5JG8pnM8AxJhVJAUEfE5eysEJvfJsGpbfuzoYE6z286KWZ2wTaf",
            "transactionStatus": true,
            "blockNumber": 310769741,
            "timestamp": 1735562150,
            "from": "GAnBH3Cnyz5eT34P6VdNZY3tHESSWK7Kwa4zMxCprdda",
            "to": "8jjWmLhYdqrtFMcEkiMDdqkEN85cvEFnNS4LFgNf5NRv",
            "value": "3521756",
            "transactionFees": 105000,
            "gas": null,
            "gasPrice": null,
            "input": "Fhr4xw,3gJqkocMWaMm,MmvJP4vqoG7gvPRcxpVfeA1T8q6SJXR2SHjtporuM6cn9XMH,3vG348ZJzGA23xZSyoxshFuogcjWfqoNumzpA4iBKwtcfSUubkADTX226ZdVjK4o4yi4tyx8VJL2HncHLzr7EcnqDRoQmBncUbdM8MFNjj9fdhk4zCtFCaUdC3vFBtXHywBsKuiq4oXTZVu7Di86anbXEa3",
            "nonce": null,
            "network": null
        },
        "dstTx": {
            "chainId": "137",
            "hash": "0xad479da4569fbba967f3f297c5a35ea3d8816a3c8af0a90e9b26f400d816316f",
            "transactionStatus": true,
            "blockNumber": "66101722",
            "timestamp": null,
            "from": "0xf27D86EFA125Ab1ff059D1858c07A24cDc18aeC4",
            "to": "0x7775d63836987f444E2F14AA0fA2602204D7D3E0",
            "value": "0",
            "transactionFees": "44622856311400180",
            "gas": "300000",
            "gasPrice": "305479077949",
            "input": "0xe43bfe5e0000000000000000000000000000000000000000000000000000000000002c200000000000000000000000006b14f5ccb78fbb80e6d931d66bd42e71b253730800000000000000000000000000000000000000000000000000000000000000040000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174b60be2af1439c94c72a5f085eb9f9cd1129a1f34bb75d8e0078aab722909eaed00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000aa8cb3",
            "nonce": 153166,
            "type": 2,
            "network": null,
            "v": "0x0",
            "r": "0x8c23c3f7164304174d376f909e90dcd8eceada06a299bd61193fa69ba6573cf1",
            "s": "0x2a2bd1220aa7bec3866c65fb79054ab9e1e8c59f19628c95a5fb24d3520be7ec",
            "yParity": "0x0",
            "transactionIndex": 30,
            "accessList": [],
            "maxFeePerGas": "448320440133",
            "maxPriorityFeePerGas": "84882656379",
            "logs": [
                {
                    "address": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x00000000000000000000000058cc621c62b0aa9babfae5651202a932279437da",
                        "0x0000000000000000000000006b14f5ccb78fbb80e6d931d66bd42e71b2537308"
                    ],
                    "data": "0x0000000000000000000000000000000000000000000000000000000000ac45b8",
                    "blockNumber": 66101722,
                    "transactionHash": "0xad479da4569fbba967f3f297c5a35ea3d8816a3c8af0a90e9b26f400d816316f",
                    "transactionIndex": 30,
                    "blockHash": "0x2cc708b9fbaa9b35fdf6915aa9d6aa08023c8750fefdbf0bb582eccb91f8cde6",
                    "logIndex": 69,
                    "removed": false,
                    "id": "log_c8b9d859"
                },
                {
                    "address": "0x58Cc621c62b0aa9bABfae5651202A932279437DA",
                    "topics": [
                        "0xfc1df7b9ba72a13350b8a4e0f094e232eebded9edd179950e74a852a0f405112"
                    ],
                    "data": "0x0000000000000000000000006b14f5ccb78fbb80e6d931d66bd42e71b25373080000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa841740000000000000000000000000000000000000000000000000000000000002c200000000000000000000000000000000000000000000000000000000000ac45b80000000000000000000000000000000000000000000000000000000000004240",
                    "blockNumber": 66101722,
                    "transactionHash": "0xad479da4569fbba967f3f297c5a35ea3d8816a3c8af0a90e9b26f400d816316f",
                    "transactionIndex": 30,
                    "blockHash": "0x2cc708b9fbaa9b35fdf6915aa9d6aa08023c8750fefdbf0bb582eccb91f8cde6",
                    "logIndex": 70,
                    "removed": false,
                    "id": "log_7b4b53f7"
                },
                {
                    "address": "0x7775d63836987f444E2F14AA0fA2602204D7D3E0",
                    "topics": [
                        "0xe9d840d27ab4032a839c20760fb995af8e3ad1980b9428980ca1c7e072acd87a"
                    ],
                    "data": "0x0000000000000000000000000000000000000000000000000000000000ac45b80000000000000000000000006b14f5ccb78fbb80e6d931d66bd42e71b2537308b60be2af1439c94c72a5f085eb9f9cd1129a1f34bb75d8e0078aab722909eaed000000000000000000000000000000000000000000000000000000000000000104054c0a8d76b15e6dbab8949fe5c253ab235e91e9274f0c6485a330100b7d8e",
                    "blockNumber": 66101722,
                    "transactionHash": "0xad479da4569fbba967f3f297c5a35ea3d8816a3c8af0a90e9b26f400d816316f",
                    "transactionIndex": 30,
                    "blockHash": "0x2cc708b9fbaa9b35fdf6915aa9d6aa08023c8750fefdbf0bb582eccb91f8cde6",
                    "logIndex": 71,
                    "removed": false,
                    "id": "log_7e84248d"
                },
                {
                    "address": "0x0000000000000000000000000000000000001010",
                    "topics": [
                        "0x4dfe1bbbcf077ddc3e01291eea2d5c70c2b422b415d95645b9adcfd678cb1d63",
                        "0x0000000000000000000000000000000000000000000000000000000000001010",
                        "0x000000000000000000000000f27d86efa125ab1ff059d1858c07a24cdc18aec4",
                        "0x000000000000000000000000794e44d1334a56fea7f4df12633b88820d0c5888"
                    ],
                    "data": "0x000000000000000000000000000000000000000000000000002c0d09a3e0ec7900000000000000000000000000000000000000000000000ab5b110650ff69f1b000000000000000000000000000000000000000000000e83d3397b9ff4356c1800000000000000000000000000000000000000000000000ab585035b6c15b2a2000000000000000000000000000000000000000000000e83d36588a998165891",
                    "blockNumber": 66101722,
                    "transactionHash": "0xad479da4569fbba967f3f297c5a35ea3d8816a3c8af0a90e9b26f400d816316f",
                    "transactionIndex": 30,
                    "blockHash": "0x2cc708b9fbaa9b35fdf6915aa9d6aa08023c8750fefdbf0bb582eccb91f8cde6",
                    "logIndex": 72,
                    "removed": false,
                    "id": "log_a600d4fa"
                }
            ]
        }
    }
}
```

{% endtab %}
{% endtabs %}

### /swap

Initiates a transaction to swap assets accross multiple chains.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/bridge/swap`

#### Request Body

| Name                                             | Type   | Description                                                                                                             |
| ------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------- |
| rpc                                              | String | Remote procedural call URL.                                                                                             |
| bridgeId<mark style="color:red;">\*</mark>       | String | Refer to the [Bridge ID](https://docs.expand.network/important-ids/bridge-id) page for details.                         |
| srcChainId<mark style="color:red;">\*</mark>     | String | [Chain Id](https://docs.expand.network/important-ids/bridge-id/internal-chain-ids-for-bridge) of the source chain.      |
| dstChainId<mark style="color:red;">\*</mark>     | String | [Chain Id](https://docs.expand.network/important-ids/bridge-id/internal-chain-ids-for-bridge) of the destination chain. |
| srcTokenSymbol<mark style="color:red;">\*</mark> | String | Source token symbol.                                                                                                    |
| dstTokenSymbol<mark style="color:red;">\*</mark> | String | Destination token symbol.                                                                                               |
| amountIn<mark style="color:red;">\*</mark>       | String | Amount of token.                                                                                                        |
| gas<mark style="color:red;">\*</mark>            | String | Maximum gas limit provided by the sender, for the transaction.                                                          |
| gas priority                                     | String | Low, medium, or high.                                                                                                   |
| from<mark style="color:red;">\*</mark>           | String | Address of the sender of the token.                                                                                     |
| to<mark style="color:red;">\*</mark>             | String | Address of the recipient of the token.                                                                                  |

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "to": "0x0CDA40b49c94502cdb58d4Ec507Fc4c842D8AF47",
    "from": "53unSgGWqEWANcPYRF35B2Bgf8BkszUtcccKiXwGGLyr",
    "srcChainId": "900",
    "dstChainId": "1",
    "srcTokenSymbol": "USDt",
    "dstTokenSymbol": "USDC",
    "bridgeId": "400",
    "amountIn": "10000000",
    "gas": "30000"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "900",
        "from": "53unSgGWqEWANcPYRF35B2Bgf8BkszUtcccKiXwGGLyr",
        "data": "AgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACkiVq4ARfMLdm5S8RbD25uG2SDbygb8qFUQUfzuhPMkr3Q7c2Wup8vMQCTTuNwCSCDb4bmQ4ydES/zhXCIh0YNgAIABQw8LZeA9qBvRbVQG5heYfyIuwarnP0Gu9tInqEHyOcglWbZK0ObGjN9q0xuRL0TUp872ZtuqzYYwm02RZXc48A+d2Gw7xpFthANVe3z0H+3p4X63midbZ0clwJz/UoaiCm5vh9YFiRrv4KzgxptVtUhoKpS+UTfyeoGgye1cN2ZtB0V2Rb9ZE0XVXPsit1LZw9urS8OZ3hmHBEVzT7XwPO8VBJRjgXCFp1PQJxqv1nDL57Hzqu6pEmojfmqT93QYzAx1DzF2wqb2QsGAV6qtX/Co/01QmyoV/2QWBlHV/r8gAMGRm/lIRcy/+ytunLDm+e8jOW7xfcSayxDmzpAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAChS802Aur3zrKUdfAJQH3aEEEs3IW1yCrPU1c5i+1xGM4BDmCv7bInF71jGS9UFFo/llozu4LSxwKess4eIIJkDgpYmkGlX71mxSpHXy2SptPcm0dHEUy5r4JamLVF085ITWCGCO8HhORNHkyfBbuHH/7aV9ZpK5q6ThKNcyBGcwQHAAUCP0IPAAgCAAwMAgAAAGQAAAAAAAAACRkAAAIKDQ4DBBESEwUUFQ8LEAEGDBYXGBkIcSlbybSWdZpB9s+SKRv0w3w5oe6HdsaDJ9uB5YE1dBj7zlOfqK3ODHUAAAAAAAAAAAAAAAAM2kC0nJRQLNtY1OxQf8TIQtivRwEAAAAAAAAAAAAAAACguGmRxiGLNsHRnUounrDONgbrSOEmAAAAAAAABwAJAw0AAAAAAAAAARNeVVcDfq5Iw8yNHuzl4KtuQqQCxlZJPgFeCVKg3hG2BSEBFh8gCRgJGQseJyMkDA==",
        "referenceId": "ca464066b53746868f9c04df914a789c"
    }
}
```

{% endtab %}
{% endtabs %}

#### With Gas Priority

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "to": "TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N",
    "from": "0xB409cB0b5DB9f148d0bc491E140D9E0FDd789C11",
    "srcChainId": "1",
    "dstChainId": "1000",
    "srcTokenSymbol": "usdc",
    "dstTokenSymbol": "usdt",
    "bridgeId": "400",
    "amountIn": "1000000",
    "gas": "30000",
    "gasPriority":"high"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "gas": "30000",
        "from": "0xB409cB0b5DB9f148d0bc491E140D9E0FDd789C11",
        "to": "0x609c690e8F7D68a59885c9132e812eEbDaAf0c9e",
        "value": "3365697621963008",
        "data": "0x4cd480bd000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4800000000000000000000000000000000000000000000000000000000000f4240000000000000000000000000bb1712d44d09feee51d071219b4c5d9792b76b290000000000000000000000000000000000000000000000000000000000000003000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c2b9dda041cc773e74cbf5f5571fc7a788943b5f36c697133cb905448300ad72700000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000",
        "gasPrice": "15182277713",
        "estimationCheck": true,
        "referenceId": "29e3be4965c74071b126b8dcb6fb9ac0"
    }
}
```

{% endtab %}
{% endtabs %}