Stargate V2

/getprice

Get the swap quotation for the given token pairs.

GET https://api.expand.network/bridge/getprice

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
amountIn*	String	Address of the pool.
address	String	Sender's public address.
srcChainId	String	Refer to the Chain ID page for details.
bridgeId	String	Refer to the Bridge ID page for details.
dstChainId*	String	Destination Chain ID.
srcTokenSymbol*	String	Source token symbol
dstTokenSymbol*	String	Destination token symbol

Sample Request

https://api.expand.network/bridge/getprice?bridgeId=500&srcTokenSymbol=USDC&srcChainId=8453&amountIn=100000000&dstChainId=42161&dstTokenSymbol=USDC

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "srcChainId": "8453",
        "dstChainId": "42161",
        "srcTokenSymbol": "USDC",
        "dstTokenSymbol": "USDC",
        "amountIn": "100000000",
        "amountsOut": [
            "100000000",
            "99994999"
        ]
    }
}

/getliquidity

Get the balance of a particular token pair of an account.

GET https://api.expand.network/bridge/getliquidity

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
srcTokenSymbol*	String	Source Token symbol
address	String	Sender's public address.
srcChainId	String	Refer to the Chain ID page for details.
bridgeId	String	Refer to the Bridge ID page for details.

Sample Request

https://api.expand.network/bridge/getliquidity?bridgeId=500&srcTokenSymbol=USDC&srcChainId=1&address=0x384897A791f1553e0eB852Cac4476dd72e0794d1

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "token": "USDC",
        "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "poolAddress": "0xc026395860Db2d07ee33e05fE50ed7bD583189C7",
        "totalLiquidity": "17043852488610",
        "userLiquidity": "1000000"
    }
}

/gettransaction

Get details of a transaction.

GET https://api.expand.network/bridge/gettransaction

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
transactionHash*	String	The transaction hash.
bridgeId	String	Refer to the Bridge ID page for details.

Sample Request

https://api.expand.network/bridge/gettransaction?transactionHash=0x8a1f55fe1b6362b998806e07bc6f1e3c93a97f4a5935d8e92042b9a616d4e81e&bridgeId=500

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "srcUaAddress": "0x5634c4a5fed09819e3c46d86a965dd9447d86e47",
        "dstUaAddress": "0x17e450be3ba9557f2378e20d64ad417e59ef9a34",
        "updated": 1746719322,
        "created": 1746719258,
        "srcChainId": "8453",
        "dstChainId": "43114",
        "dstTxHash": "0x58ec8ac4291698cc14759926b701301214a1df7ca65850873e4b87ae3dffc15a",
        "srcTxHash": "0x8a1f55fe1b6362b998806e07bc6f1e3c93a97f4a5935d8e92042b9a616d4e81e",
        "srcBlockHash": "0xd9abe0f0d1ca5db901f5a348dd5d61688cebd2ae23d9b99972bd8dddb600446f",
        "srcBlockNumber": "29964954",
        "srcUaNonce": 12364,
        "status": "DELIVERED",
        "data": {
            "srcTx": null,
            "dstTx": {
                "blockHash": "0xaf34d35ca4e13dd1b14e257747c27c93b89e968a3488ce242833dec385460f35",
                "blockNumber": 61672682,
                "from": "0xe93685f3bBA03016F02bD1828BaDD6195988D950",
                "gas": 450020,
                "gasPrice": "12092073876",
                "hash": "0x58ec8ac4291698cc14759926b701301214a1df7ca65850873e4b87ae3dffc15a",
                "input": "0xcfc32570000000000000000000000000000000000000000000000000000000000000002000000000000000000000000017e450be3ba9557f2378e20d64ad417e59ef9a3400000000000000000000000000000000000000000000000000000000000075e80000000000000000000000005634c4a5fed09819e3c46d86a965dd9447d86e47000000000000000000000000000000000000000000000000000000000000304cbc3dba1b033d80f0cc1cec5c10f24565caae16f1411721f9eb6bd87913a129fe000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001600000000000000000000000000000000000000000000000000000000000029428000000000000000000000000000000000000000000000000000000000000002b010001000000000000000000000000446a0fe937c5f8a45c44d6b7f8b99132803f89f20000000008fd65c90000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
                "nonce": 10181473,
                "to": "0x90E595783E43eb89fF07f63d27B8430e6B44bD9c",
                "transactionIndex": 7,
                "value": "0",
                "type": 0,
                "chainId": "0xa86a",
                "v": "0x150f8",
                "r": "0x4aca6fc5395aa3ad557e64e2acbd1f83e1819f808af76bb059e4de4676be968d",
                "s": "0x4fbe87728d4b2a9fa5f636d7aaa5578171dfa3d90daf6f5e41bd697bd8f0f469"
            }
        }
    }
}

/swap

Swap assets across multiple chains.

POST https://api.expand.network/bridge/swap

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
bridgeId	String	Refer to the Bridge ID page for details.
srcTokenSymbol*	String	Symbol of token to swap.
dstChainId*	String	Destination chain Id. Refer to the Chain ID page for details.
amountIn*	String	Amount of token to be swapped.
from*	String	Address of the sender of the token.
amountOutMin*	String	Minimum amount accepted as the result of swap.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
to	String	Address of the recipient of the token.
dstTokenSymbol	String	Symbol of token to be received as a result of swap.
srcChainId	String	Source Chain Id. By default, Ethereum mainnet. Refer to the Chain ID page for details.
srcChainSymbol	String	Source Chain Symbol.
slippage	String	Percentage of total swap value. By default, 1. 0 <= slippage value <= 100
gasPriority	String	low, medium, or high.
transferMode	String	Mode of transport-bus or taxi. By default, taxi
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

Sample Request

{
    "srcChainId": "8453",
    "dstChainId": "1",
    "srcTokenSymbol": "ETH",
    "dstTokenSymbol": "ETH",
    "amountIn": "10000000000000000",
    "gas": "80000",
    "bridgeId": "500",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "amountOutMin": "0",    
    "transferMode": "bus"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "8453",
        "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
        "to": "0xdc181Bd607330aeeBEF6ea62e03e5e1Fb4B6F7C7",
        "value": "20667275745583704",
        "gas": "80000",
        "data": "0xc7c7f5b300000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000025e5d4ad8962560000000000000000000000000000000000000000000000000000000000000000000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b4020000000000000000000000000000000000000000000000000000000000007595000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b402000000000000000000000000000000000000000000000000002386f26fc10000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010100000000000000000000000000000000000000000000000000000000000000",
        "estimationCheck": true,
        "referenceId": "7deb208a16e5441d98f0703c1eac132d"
    }
}

Sample Request

With gasPriority:

{
    "srcChainId": "8453",
    "dstChainId": "1",
    "srcTokenSymbol": "ETH",
    "dstTokenSymbol": "ETH",
    "amountIn": "10000000000000000",
    "gas": "80000",
    "bridgeId": "500",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "amountOutMin": "0",
    "transferMode": "bus",
    "gasPriority": "low"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "8453",
        "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
        "to": "0xdc181Bd607330aeeBEF6ea62e03e5e1Fb4B6F7C7",
        "value": "20667275745583704",
        "gas": "80000",
        "data": "0xc7c7f5b300000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000025e5d4ad8962560000000000000000000000000000000000000000000000000000000000000000000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b4020000000000000000000000000000000000000000000000000000000000007595000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b402000000000000000000000000000000000000000000000000002386f26fc10000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010100000000000000000000000000000000000000000000000000000000000000",
        "gasPrice": "7825180",
        "estimationCheck": "Returned error: failed with 140000000 gas: insufficient funds for gas * price + value: address 0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402 have 0 want 20667275745583704",
        "referenceId": "de4c9482c5834faaa1c984928fe84200"
    }
}

/addliquidity

Loan your assets to the specified bridge.

POST https://api.expand.network/bridge/addliquidity

Request Body

Name	Type	Description
bridgeId	String	Refer to the Bridge ID page for details.
rpc	String	Remote procedural call URL.
srcChainId	String	Source Chain Id. By default, Ethereum mainnet. Refer to the Chain ID page for details.
srcTokenSymbol*	String	Symbol of token to add liquidity.
from*	String	Address of the sender of the token.
amountIn*	String	Amount of token to add liquidity.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

Sample Request

{
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "amountIn": "10000000000000000",
    "srcChainId": "8453",
    "srcTokenSymbol": "ETH",
    "gas": "2002",
    "bridgeId": "500"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "8453",
        "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
        "to": "0xdc181Bd607330aeeBEF6ea62e03e5e1Fb4B6F7C7",
        "value": "10000000000000000",
        "gas": "2002",
        "data": "0x47e7ef24000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b402000000000000000000000000000000000000000000000000002386f26fc10000",
        "estimationCheck": true,
        "referenceId": "b368c9f69c0447059b2bf6bba32ff766"
    }
}

Sample Request

With gasPriority:

{
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "amountIn": "10000000000000000",
    "srcChainId": "8453",
    "srcTokenSymbol": "ETH",
    "gas": "2002",
    "bridgeId": "500",
   "gasPriority": "medium"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "8453",
        "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
        "to": "0xdc181Bd607330aeeBEF6ea62e03e5e1Fb4B6F7C7",
        "value": "10000000000000000",
        "gas": "2002",
        "data": "0x47e7ef24000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b402000000000000000000000000000000000000000000000000002386f26fc10000",
        "gasPrice": "9165589",
        "estimationCheck": true,
        "referenceId": "b0d590d48c10479eabbe5fd8cbb352fc"
    }
}

/removeliquidity

Remove user liquidity across multiple chains.

POST https://api.expand.network/bridge/removeliquidity

Request Body

Name	Type	Description
bridgeId	String	Refer to the Bridge ID page for details.
rpc	String	Remote procedural call URL.
srcChainId	String	Source Chain Id. By default, Ethereum mainnet. Refer to the Chain ID page for details.
srcTokenSymbol*	String	Symbol of token to add liquidity.
from*	String	Address of the sender of the token.
to*	String	Address of the reciever of the token.
amountOut*	String	Amount of token to remove liquidity.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

Sample Request

{
    "srcChainId": "1",
    "bridgeId": "500",
    "srcTokenSymbol": "ETH",
    "amountOut": "10000000",
    "gas": "400000",
    "from": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e",
    "to": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e",
        "to": "0x77b2043768d28E9C9aB44E1aBfC95944bcE57931",
        "value": "0",
        "gas": "47589",
        "data": "0x7bde82f20000000000000000000000000000000000000000000000000000000000989680000000000000000000000000e58aa11a1ad425b12b4a3155124245cd36da4f5e",
        "estimationCheck": true,
        "referenceId": "4d56aef5b4c94408b983c10bfbb5e4a6"
    }
}

Sample Request

With gasPriority:

{
    "srcChainId": "1",
    "bridgeId": "500",
    "srcTokenSymbol": "ETH",
    "amountOut": "10000000",
    "gas": "400000",
    "from": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e",
    "to": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e",
    "gasPriority": "high"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e",
        "to": "0x77b2043768d28E9C9aB44E1aBfC95944bcE57931",
        "value": "0",
        "gas": "47589",
        "data": "0x7bde82f20000000000000000000000000000000000000000000000000000000000989680000000000000000000000000e58aa11a1ad425b12b4a3155124245cd36da4f5e",
        "gasPrice": "36342138491",
        "estimationCheck": true,
        "referenceId": "aeb9a7490c744503902302842b9c31b5"
    }
}

Sample Request

With ofacCheck:

{
    "srcChainId": "1",
    "bridgeId": "500",
    "srcTokenSymbol": "ETH",
    "amountOut": "10000000",
    "gas": "400000",
    "from": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e",
    "to": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e",
    "gasPriority": "high",
    "ofacCheck": true
}

Sample Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xe58Aa11A1AD425b12B4a3155124245cd36DA4f5e",
        "to": "0x77b2043768d28E9C9aB44E1aBfC95944bcE57931",
        "value": "0",
        "gas": "47589",
        "data": "0x7bde82f20000000000000000000000000000000000000000000000000000000000989680000000000000000000000000e58aa11a1ad425b12b4a3155124245cd36da4f5e",
        "gasPrice": "31781792604",
        "estimationCheck": true,
        "insights": {
            "issues": [],
            "verdict": {
                "code": 0,
                "label": "NO_ISSUES"
            }
        },
        "referenceId": "a78f1963a84a44b08e4eb3fbec61a991"
    }
}