/getprice
Returns the swap quotation for the given token pair.
GET
https://api.expand.network/dex/getprice
Query Parameters
Remote procedural call URL.
Comma separated values of token addresses whose price is to be fetched.
https://api.expand.network/dex/getprice?dexId=2300&path=EQBynBO23ywHy_CgarY9NK9FTz0yDsG82PtcbSTQgGoXwiuA,EQB5Wjo7yXdaB70yBoN2YEv8iVPjAdMObf_Dq40ELLaPllNb&amountIn=1
{
"status": 200,
"msg": "success",
"data": {
"amountIn": "1",
"path": [
"EQBynBO23ywHy_CgarY9NK9FTz0yDsG82PtcbSTQgGoXwiuA",
"EQB5Wjo7yXdaB70yBoN2YEv8iVPjAdMObf_Dq40ELLaPllNb"
],
"amountsOut": [
"1",
"22018"
]
}
}
/getuserliquidity
Returns the balance of a particular token pair of an account.
GET
https://api.expand.network/dex/getuserliquidity
Query Parameters
Remote procedural call URL.
Public address of liquidity provider.
https://api.expand.network/dex/getuserliquidity?tokenA=EQBT2Ee4Lx5w9uI7oMly5upXNs3ABWL_Fwk1uiM74gZCGaYt&tokenB=EQC47093oX5Xhb0xuk2lCr2RhS8rj-vul61u4W2UH5ORmG_O&address=UQAAjw7MBB_2-DvNKsjtOAPJBeqTK8iiDl8Xyv37zbIRbKrt&dexId=2300
{
"status": 200,
"msg": "success",
"data": {
"tokenA": "12544748660283056",
"tokenB": "295478740252006"
}
}
/getpoolliquidity
Returns the total liquidity for a specified pool.
GET
https://api.expand.network/dex/getpoolliquidity
Query Parameters
Remote procedural call URL.
Pool address whose liquidity is to be fetched.
https://api.expand.network/dex/getpoolliquidity?poolAddress=EQAZFS5dJ8STrKcn5VnptYsoKILXbAYaDhdJJjbzUrNkDdH_&dexId=2300
{
"status": 200,
"msg": "success",
"data": {
"totalLiquidity": "149487260181"
}
}
/gettokenliquidity
Returns the individual token liquidity within the specified liquidity pool.
GET
https://api.expand.network/dex/gettokenliquidity
Query Parameters
Remote procedural call URL.
https://api.expand.network/dex/gettokenliquidity?poolAddress=EQD1c0gDs91J-9FzeiC_V9VbizFxDUs09P6eIO4Fe4l2WDbm&dexId=2300
{
"status": 200,
"msg": "success",
"data": {
"tokenA": "19467094",
"tokenB": "1028"
}
}
/getliquidityholders
Returns the total number of liquidity holders in the specified pool.
GET
https://api.expand.network/dex/getliquidityholders
Query Parameters
Remote procedural call URL.
https://api.expand.network/dex/getliquidityholders?poolAddress=EQAZFS5dJ8STrKcn5VnptYsoKILXbAYaDhdJJjbzUrNkDdH_&dexId=2300
{
"status": 200,
"msg": "success",
"data": {
"totalTokenHolders": "157"
}
}
/swap
Initiate a swap transaction on a specified DEX.
POST
https://api.expand.network/dex/swap
Request Body
Comma-separated values of token addresses, inside an array, to swap.
Amount of token to be swapped.
Minimum amount accepted as the result of swap.
Address of the sender of the token.
Maximum gas limit provided by the sender, for the transaction.
Remote procedural call URL.
If a base token is involved in the swap;
0
for jetton -> jetton,
1
for native -> jetton,
2
for jetton -> native.
By default, 0
.
Percentage of total swap value.
By default, 1.
0 <= slippage value <= 100
The query id, used to identify your transaction.
{
"dexId": "2300",
"amountIn": "100",
"amountOutMin": "0",
"path": [
"EQBynBO23ywHy_CgarY9NK9FTz0yDsG82PtcbSTQgGoXwiuA",
"EQA2kCVNwVsil2EM2mB0SkXytxCqQjS4mttjDpnXmwG9T6bO"
],
"from": "UQAxmMo2wxu_yQTySoV7u7-Con2csmcBloW0CrflBCQEr-7R",
"referralAddress": "UQAxmMo2wxu_yQTySoV7u7-Con2csmcBloW0CrflBCQEr-7R",
"queryId": "1",
"involveBaseToken": "0",
"gas": "123"
}
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1100",
"to": "0:73d110ca89db91fcb58feaa567a0448a8db0635a1c6076509dea8439c6d351be",
"value": "320000000",
"message": "te6ccsEBAgEAogAANwFnD4p+pQAAAAAAAAABFkgA7zuZAqJxsqAciTilI8/iTnGEeq62piAAHtRKd6wOcJwQPy5RAwEA0SWThWGAEPckSDVNSvvmJOKMGCE4qb+zE0NdQGXsIPpYy63RDznBAAxmMo2wxu/yQTySoV7u7+Con2csmcBloW0CrflBCQEr8ADGYyjbDG7/JBPJKhXu7v4KifZyyZwGWhbQKt+UEJASvoaQiNw="
}
}
With Slippage:
{
"dexId": "2300",
"amountIn": "100",
"amountOutMin": "0",
"path": [
"EQBynBO23ywHy_CgarY9NK9FTz0yDsG82PtcbSTQgGoXwiuA",
"EQA2kCVNwVsil2EM2mB0SkXytxCqQjS4mttjDpnXmwG9T6bO"
],
"from": "UQAxmMo2wxu_yQTySoV7u7-Con2csmcBloW0CrflBCQEr-7R",
"referralAddress": "UQAxmMo2wxu_yQTySoV7u7-Con2csmcBloW0CrflBCQEr-7R",
"queryId": "1",
"slippage": "10",
"involveBaseToken": "0",
"gas": "123"
}
With Slippage:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1100",
"to": "0:73d110ca89db91fcb58feaa567a0448a8db0635a1c6076509dea8439c6d351be",
"value": "320000000",
"message": "te6ccsEBAgEAogAANwFnD4p+pQAAAAAAAAABFkgA7zuZAqJxsqAciTilI8/iTnGEeq62piAAHtRKd6wOcJwQPy5RAwEA0SWThWGAEPckSDVNSvvmJOKMGCE4qb+zE0NdQGXsIPpYy63RDznBAAxmMo2wxu/yQTySoV7u7+Con2csmcBloW0CrflBCQEr8ADGYyjbDG7/JBPJKhXu7v4KifZyyZwGWhbQKt+UEJASvoaQiNw="
}
}
/addliquidity
Add liquidity to a specified pool in a specified DEX.
POST
https://api.expand.network/dex/addliquidity
Request Body
Address of the first token being added.
Address of the second token being added.
Desired amount of token A.
Desired amount of token B.
Minimum amount of token A.
Minimum amount of token B.
Address of the sender of the token.
Maximum gas limit provided by the sender, for the transaction.
Remote procedural call URL.
Percentage of total value.
By default, 1.
0 <= slippage value <= 100
The query id, used to identify your transaction.
{
"dexId": "2300",
"tokenA": "EQBynBO23ywHy_CgarY9NK9FTz0yDsG82PtcbSTQgGoXwiuA",
"tokenB": "EQA2kCVNwVsil2EM2mB0SkXytxCqQjS4mttjDpnXmwG9T6bO",
"amountADesired": "1100",
"amountBDesired": "411858",
"amountAMin": "1",
"amountBMin": "1",
"queryId": "166978170",
"from": "UQAxmMo2wxu_yQTySoV7u7-Con2csmcBloW0CrflBCQEr-7R",
"gas": "230000"
}
{
"status": 200,
"msg": "success",
"data": {
"jetton0Transaction": {
"chainId": "1100",
"to": "0:73d110ca89db91fcb58feaa567a0448a8db0635a1c6076509dea8439c6d351be",
"value": "320000000",
"message": "te6ccsEBAgEAYQAAOAFpD4p+pQAAAAAJ8+J6IETIAO87mQKicbKgHIk4pSPP4k5xhHqutqYgAB7USnesDnCcED8uUQMBAE38+eWPgBD3JEg1TUr75iTijBghOKm/sxNDXUBl7CD6WMut0Q85wgN+Gc78"
},
"jetton1Transaction": {
"chainId": "1100",
"to": "0:f74345def726901e85075be154c7b5066f30a3386c8df01ed3e76fc20cff4ad4",
"value": "320000000",
"message": "te6ccsEBAgEAYgAAOQFrD4p+pQAAAAAJ8+J6MGSNKADvO5kConGyoByJOKUjz+JOcYR6rramIAAe1Ep3rA5wnBA/LlEDAQBN/Pnlj4AClYDlisUiRlr5snu9gkBGuLy568QE/pN3i1RO3LpEmwIDgzC5aA=="
},
"referenceId": "d731d01873364afda14b1f6041f8508d"
}
}
With Slippage:
{
"dexId": "2300",
"tokenA": "EQBynBO23ywHy_CgarY9NK9FTz0yDsG82PtcbSTQgGoXwiuA",
"tokenB": "EQA2kCVNwVsil2EM2mB0SkXytxCqQjS4mttjDpnXmwG9T6bO",
"amountADesired": "1100",
"amountBDesired": "411858",
"amountAMin": "1",
"amountBMin": "1",
"slippage": "1",
"queryId": "166978170",
"from": "UQAxmMo2wxu_yQTySoV7u7-Con2csmcBloW0CrflBCQEr-7R",
"gas": "230000"
}
With Slippage:
{
"status": 200,
"msg": "success",
"data": {
"jetton0Transaction": {
"chainId": "1100",
"to": "0:73d110ca89db91fcb58feaa567a0448a8db0635a1c6076509dea8439c6d351be",
"value": "320000000",
"message": "te6ccsEBAgEAYQAAOAFpD4p+pQAAAAAJ8+J6IETIAO87mQKicbKgHIk4pSPP4k5xhHqutqYgAB7USnesDnCcED8uUQMBAE38+eWPgBD3JEg1TUr75iTijBghOKm/sxNDXUBl7CD6WMut0Q85wgN+Gc78"
},
"jetton1Transaction": {
"chainId": "1100",
"to": "0:f74345def726901e85075be154c7b5066f30a3386c8df01ed3e76fc20cff4ad4",
"value": "320000000",
"message": "te6ccsEBAgEAYgAAOQFrD4p+pQAAAAAJ8+J6MGSNKADvO5kConGyoByJOKUjz+JOcYR6rramIAAe1Ep3rA5wnBA/LlEDAQBN/Pnlj4AClYDlisUiRlr5snu9gkBGuLy568QE/pN3i1RO3LpEmwIDgzC5aA=="
},
"referenceId": "5274a75ef842459490e4fa496793fee5"
}
}
/removeliquidity
Remove liquidity from a specified pool for a specified DEX.
POST
https://api.expand.network/dex/removeliquidity
Request Body
Address of the first token being removed.
Address of the second token being removed.
Total amount of liquidity to be removed from the given pool.
Address of the sender of the token.
Maximum gas limit provided by the sender, for the transaction.
Remote procedural call URL.
The query id, used to identify your transaction.
{
"dexId": "2300",
"tokenA": "EQBynBO23ywHy_CgarY9NK9FTz0yDsG82PtcbSTQgGoXwiuA",
"tokenB": "EQA2kCVNwVsil2EM2mB0SkXytxCqQjS4mttjDpnXmwG9T6bO",
"liquidity": "20",
"queryId": "0",
"from": "UQAxmMo2wxu_yQTySoV7u7-Con2csmcBloW0CrflBCQEr-7R",
"gas": "230000"
}
{
"status": 400,
"msg": "failed to query",
"data": {
"chainId": "1100",
"to": "0:dbcb1554a8c4a09df5d1120e18b2286a1b23c75369d7a0f5d6e87b0878217b17",
"value": "520000000",
"message": "te6ccsEBAQEAMQAAAF1ZXwe8AAAAAAAAAAARSABjMZRthjd/kgnklQr3d38FRPs5ZM4DLQtoFW/KCEgJX2HFnx0=",
"referenceId": "a5988b49652e473d9c9cd1baf4bb128c"
}
}
Last updated