Stargate

/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.
poolAddress*	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.
srcChainSymbol	String	Source Chain Symbol.

Sample Request

https://api.expand.network/bridge/getliquidity?bridgeId=100&poolAddress=0xdf0770dF86a8034b3EFEf0A1Bb3c889B8332FF56&srcChainId=1

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "poolId": "1",
        "poolName": "USD Coin-LP",
        "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "totalLiquidity": "44319250983738"
    }
}

/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.
srcChainId	String	By default, Ethereum mainnet. Refer to the Chain ID page for details.
network*	String	Mainnet or Testnet.
srcChainSymbol	String	Source Chain Symbol.

Sample Request

https://api.expand.network/bridge/gettransaction?bridgeId=100&network=mainnet&srcChainId=137&transactionHash=0xe8a0ebe3d5c36879c5a951c9faf65608b8a9c8b2e7e3c8471e25f5767a390b28

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "srcUaAddress": "0xffdf4fe05899c4bdb1676e958fa9f21c19ecb9d5",
        "dstUaAddress": "0x3668c325501322ceb5a624e95b9e16a019cdebe8",
        "updated": 1692598184,
        "created": 1692596899,
        "srcChainId": 109,
        "dstChainId": 102,
        "dstTxHash": "0xefd030f66e9c0aaf9bab4006e5bc2c86fb7e3091f6fb4d4b14d96dd1de25927f",
        "dstTxError": null,
        "srcTxHash": "0xe8a0ebe3d5c36879c5a951c9faf65608b8a9c8b2e7e3c8471e25f5767a390b28",
        "srcBlockHash": "0xe39eaa0b9001287d57e7c75b89c2012736f81616b94ac88020d873225249fe02",
        "srcBlockNumber": "46565902",
        "srcUaNonce": 106257,
        "status": "DELIVERED",
        "data": {
            "srcTx": {
                "blockHash": "0xe39eaa0b9001287d57e7c75b89c2012736f81616b94ac88020d873225249fe02",
                "blockNumber": 46565902,
                "from": "0x23713B8033d058bF06AeEF1ac31f598FD6E63670",
                "gas": 302431,
                "gasPrice": "80611547567",
                "maxFeePerGas": "100467218838",
                "maxPriorityFeePerGas": "30000000000",
                "hash": "0xe8a0ebe3d5c36879c5a951c9faf65608b8a9c8b2e7e3c8471e25f5767a390b28",
                "input": "0xcfc93274000000000000000000000000141a1fb33683c304da7c3fe6fc6a49b5c0c2dc4200000000000000000000000000000000000000000000000000000000000c6e5c000000000000000000000000000000000000000000000000000000000000006600000000000000000000000023713b8033d058bf06aeef1ac31f598fd6e6367000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002200010000000000000000000000000000000000000000000000000000000000055730000000000000000000000000000000000000000000000000000000000000",
                "nonce": 11,
                "to": "0xFFdF4Fe05899C4BdB1676e958FA9F21c19ECB9D5",
                "transactionIndex": 32,
                "value": "2002624217015228761",
                "type": 2,
                "accessList": [],
                "chainId": "0x89",
                "v": "0x0",
                "r": "0x67567a964d1cc84ba5bb1e1f5450bdb6d3e6300036c2d187b976682652a9ee27",
                "s": "0x3536dda5e452136cf26158fa98b9a63c7e6970b9ecfb646035366b217f417f11"
            },
            "dstTx": {
                "blockHash": "0x0a0898e738723fee44fdbf29932b7d5543ca7835a52790c0a73e89f002e47992",
                "blockNumber": 31038974,
                "from": "0xe93685f3bBA03016F02bD1828BaDD6195988D950",
                "gas": 1743140,
                "gasPrice": "3600000000",
                "hash": "0xefd030f66e9c0aaf9bab4006e5bc2c86fb7e3091f6fb4d4b14d96dd1de25927f",
                "input": "0x252f7b01000000000000000000000000000000000000000000000000000000000000006d0000000000000000000000003668c325501322ceb5a624e95b9e16a019cdebe80000000000000000000000000000000000000000000000000000000000055730e39eaa0b9001287d57e7c75b89c2012736f81616b94ac88020d873225249fe026162a55473874a43b353c1b32efb170ff5fdd27e7a4febf9d6382fd50390dea000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000e8000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000030000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001e00000000000000000000000000000000000000000000000000000000000000093f891a04b37d5c424fc5e8ccb7c4b07169f5a73a3e3fbf9c513f93a4251184fba94a3e9a07787079f5830dcc472de67633c3391040053598530290d166d43d2861caf999fa0dfeb3ffddf7ebdd484fbb5f6cda490a79c175c387320766857fa28aed71e20ce8080808080a040889b98d35fa12c1dadd68c3f8cf8156188d96ca1ce9fcba6b15171be8ace3e8080808080808080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000093f891a00a797c7f5429e959b5e69b473878199bb2c2483b69860089498da0f8673bdd03a06aa5d1ef923b055973445e2f02fa6089652ae37946b4c6279ad204c0352d78b0a093b0cc513f3c7582bc7ea8ab699a171475abd986822df5693f4bba86cde76869a0ae5d734859d9245d7282cdbe822bdc067ab995bfe0a88d27be099b8a146dc97a80808080808080808080808080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000b7ef90b7b20b90b7702f90b7301835c643ab901000000000000000000000000000000000000004000000040000010000180000000000400000440040000000010011200000000c400000000000000000000000000006000000000000000000008000000800000000000000000100100000020000000040000000000000000000000500000000000000000000081000010000000000100000000000000000010001000080000000000280000040000000000000080202000000000025000000004040000000200000000000000000000000000804000001042800008000001000000001000800001000000c00000108000000000001000800000000000000000800000200000000000000000000000000000100000f90a68f9013d940000000000000000000000000000000000001010f884a0e6497e3ee548a3372136af2fcb0696db31fc6cf20260707645068bd3fe97f3c4a00000000000000000000000000000000000000000000000000000000000001010a000000000000000000000000023713b8033d058bf06aeef1ac31f598fd6e63670a0000000000000000000000000ffdf4fe05899c4bdb1676e958fa9f21c19ecb9d5b8a00000000000000000000000000000000000000000000000001bcac01d71c999590000000000000000000000000000000000000000000000008a8c1252cc1222e00000000000000000000000000000000000000000000000a3d1497749a0ee00000000000000000000000000000000000000000000000000006ec152355a4889870000000000000000000000000000000000000000000000a3ed14376712b79959f89c94141a1fb33683c304da7c3fe6fc6a49b5c0c2dc42f884a0ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa000000000000000000000000023713b8033d058bf06aeef1ac31f598fd6e63670a0000000000000000000000000ffdf4fe05899c4bdb1676e958fa9f21c19ecb9d5a000000000000000000000000000000000000000000000000000000000000c6e5c80f9013d940000000000000000000000000000000000001010f884a0e6497e3ee548a3372136af2fcb0696db31fc6cf20260707645068bd3fe97f3c4a00000000000000000000000000000000000000000000000000000000000001010a0000000000000000000000000ffdf4fe05899c4bdb1676e958fa9f21c19ecb9d5a00000000000000000000000003c2269811836af69497e5f486a85d7316753cf62b8a000000000000000000000000000000000000000000000000017a0efb4592b99590000000000000000000000000000000000000000000000a3ed14376712b7995900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a3d57347b2b98c000000000000000000000000000000000000000000000000000017a0efb4592b9959f9013d940000000000000000000000000000000000001010f884a0e6497e3ee548a3372136af2fcb0696db31fc6cf20260707645068bd3fe97f3c4a00000000000000000000000000000000000000000000000000000000000001010a00000000000000000000000003c2269811836af69497e5f486a85d7316753cf62a00000000000000000000000004d73adb72bc3dd368966edd0f0b2148401a178e2b8a000000000000000000000000000000000000000000000000017a0efb4592b995900000000000000000000000000000000000000000000000017a0efb4592b9959000000000000000000000000000000000000000000000ea895645259761089a10000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ea8ad05420dcf3c22faf8589475dc8e5f50c8221a82ca6af64af811caa983b65fe1a0df21c415b78ed2552cc9971249e32a053abce6087a0ae0fbf3f78db5174a3493a00000000000000000000000000000000000000000000000000ef47d84108d1959f8d9944d73adb72bc3dd368966edd0f0b2148401a178e2e1a0b0c632f55f1e1b3b2c3d82f41ee4716bb4c00f0f5d84cdafc141581bb8757a4fb8a000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002200010000000000000000000000000000000000000000000000000000000000055730000000000000000000000000000000000000000000000000000000000000f8d9949d88a2f4253b106a1f8e169485490f7230b4276ee1a0daebd99ba0f67a2d7a70d027ab177cad40ce040f65a9c4d98544a5463a172ebdb8a0000000000000000000000000000000000000000000000000000000000000006600000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000200000000000000000000000000ffdf4fe05899c4bdb1676e958fa9f21c19ecb9d500000000000000000000000000000000000000000000000008ac7230489e8000f901ba944d73adb72bc3dd368966edd0f0b2148401a178e2e1a0e9bded5f24a4168e4f3bf44e00298c993b22376aad8c58c7dda9718a54cbea82b901800000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000012a0000000000019f11006dffdf4fe05899c4bdb1676e958fa9f21c19ecb9d500663668c325501322ceb5a624e95b9e16a019cdebe8141a1fb33683c304da7c3fe6fc6a49b5c0c2dc42006d50616e6472613a20506978656c50726f776c657200000000000000000000000050616e6472613a20506978656c50726f776c657200000000000000000000000000000000000000000000000000000000000000000000000000000000000c6e5c23713b8033d058bf06aeef1ac31f598fd6e63670006668747470733a2f2f676174657761792e70696e6174612e636c6f75642f697066732f516d57784262464733574a585654447172465550684d754c6d6548714b4e42426b7a5375765179796b37667466692f506978656c50726f776c65722d506f6c79676f6e2e6a736f6e00000000000000000000000000000000000000000000f8fb94ffdf4fe05899c4bdb1676e958fa9f21c19ecb9d5f842a0e11d2ca26838f15acb41450029a785bb3d6f909b7f622ebf9c45524ded76f411a00000000000000000000000000000000000000000000000000000000000019f11b8a0000000000000000000000000141a1fb33683c304da7c3fe6fc6a49b5c0c2dc4200000000000000000000000000000000000000000000000000000000000c6e5c000000000000000000000000000000000000000000000000000000000000006600000000000000000000000023713b8033d058bf06aeef1ac31f598fd6e6367000000000000000000000000023713b8033d058bf06aeef1ac31f598fd6e63670f9013d940000000000000000000000000000000000001010f884a04dfe1bbbcf077ddc3e01291eea2d5c70c2b422b415d95645b9adcfd678cb1d63a00000000000000000000000000000000000000000000000000000000000001010a000000000000000000000000023713b8033d058bf06aeef1ac31f598fd6e63670a0000000000000000000000000a8b52f02108aa5f4b675bdcc973760022d7c6020b8a0000000000000000000000000000000000000000000000000001b916a461c2c000000000000000000000000000000000000000000000000008ae2af4965357dd100000000000000000000000000000000000000000000033575fd8f56f4aa1dbd0000000000000000000000000000000000000000000000008ac71ddf1f1951d1000000000000000000000000000000000000000000000335761920c13ac649bd00000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001",
                "nonce": 6441901,
                "to": "0xA27A2cA24DD28Ce14Fb5f5844b59851F03DCf182",
                "transactionIndex": 6,
                "value": "0",
                "type": 0,
                "v": "0x94",
                "r": "0xc654980e14fa800c7913154d03fb92a64ad3ced94ebd0485d021dfbab29f7465",
                "s": "0x475936be140c7e220b47949a01a14c6236379d4863fa6a35787dc782cd6fe04"
            }
        }
    }
}

/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 <= 10
gasPriority	String	low, medium, or high.

Sample Request

{
    "srcTokenSymbol": "USDC",
    "amountIn": "10000",
    "amountOutMin": "1000",
    "gas": "10000",
    "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994",
    "dstChainId": "137"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994",
        "to": "0x8731d54E9D02c286767d56ac03e8037C07e01e98",
        "value": "5152267364791416",
        "gas": "10000",
        "data": "0x9fbf10fc000000000000000000000000000000000000000000000000000000000000006500000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e5994000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000003e8000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000001e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014a67e9b68c41b0f26184d64c26e0b2b81466e59940000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
}

Sample Request

With gasPriority:

{
    "srcChainId": "1",
    "bridgeId": "100",
    "srcTokenSymbol": "USDC",
    "amountIn": "10000",
    "gas": "900000",
    "gasPriority": "low",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "dstChainId": "137",
    "amountOutMin": "100"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
        "to": "0x7612aE2a34E5A363E137De748801FB4c86499152",
        "value": "7432363398213",
        "gas": "385815",
        "data": "0x9fbf10fc000000000000000000000000000000000000000000000000000000000000277d00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e599400000000000000000000000000000000000000000000000000000000000027100000000000000000000000000000000000000000000000000000000000000064000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000001e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014a67e9b68c41b0f26184d64c26e0b2b81466e59940000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
}

Sample Request

With slippage:

{
    "srcChainId": "1",
    "srcTokenSymbol": "USDC",
    "amountIn": "10000",
    "amountOutMin": "100",
    "gas": "10000",
    "slippage": "4",
    "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994",
    "dstChainId": "137"
}

Sample Response

With slippage:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994",
        "to": "0x8731d54E9D02c286767d56ac03e8037C07e01e98",
        "value": "408888691745393",
        "gas": "10000",
        "data": "0x9fbf10fc000000000000000000000000000000000000000000000000000000000000006d00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e599400000000000000000000000000000000000000000000000000000000000027100000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000001e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014a67e9b68c41b0f26184d64c26e0b2b81466e59940000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
}

/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.
srcChainSymbol	String	Source Chain Symbol.
gasPriority	String	low, medium, or high.

Sample Request

{
    "srcChainId": "1",
    "bridgeId": "100",
    "srcTokenSymbol": "USDT",
    "amountIn": "10000000",
    "gas": "400000",
    "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994",
        "to": "0x8731d54E9D02c286767d56ac03e8037C07e01e98",
        "value": "0",
        "gas": "400000",
        "data": "0x87b21efc00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000989680000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e5994"
    }
}

Sample Request

With gasPriority:

{
    "srcChainId": "1",
    "bridgeId": "100",
    "srcTokenSymbol": "USDC",
    "amountIn": "10000",
    "gas": "890000",
    "gasPriority": "medium",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
        "to": "0x7612aE2a34E5A363E137De748801FB4c86499152",
        "value": "0",
        "gas": "133992",
        "data": "0x87b21efc00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000002710000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e5994"
    }
}

/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.
amountOut*	String	Amount of token to remove liquidity.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
srcChainSymbol	String	Source Chain Symbol.
gasPriority	String	low, medium, or high.

Sample Request

{
    "srcChainId": "1",
    "bridgeId": "100",
    "srcTokenSymbol": "USDT",
    "amountOut": "10000000",
    "gas": "400000",
    "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994",
        "to": "0x8731d54E9D02c286767d56ac03e8037C07e01e98",
        "value": "0",
        "gas": "400000",
        "data": "0xc4de93a500000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000989680000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e5994"
    }
}

Sample Request

With gasPriority:

{
    "srcChainId": "1",
    "bridgeId": "100",
    "srcTokenSymbol": "USDC",
    "amountOut": "10000",
    "gas": "100000",
    "gasPriority": "high",
    "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xa67e9b68c41b0f26184d64c26e0b2b81466e5994",
        "to": "0x7612aE2a34E5A363E137De748801FB4c86499152",
        "value": "0",
        "gas": "141639",
        "data": "0xc4de93a500000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000002710000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e5994"
    }
}