⛽获取资金池和代币价格信息
API URL: [POST] https://utxoswap.xyz/utxo-swap/api/v1/sequencer/pools
Header:
x-api-key: UTXOSwap SDK Key
获取 apiKey：您可以通过联系 developer@utxoswap.xyz 来免费获取一个 apiKey，这是访问 UTXOSwap 后端服务的必需条件。
Input params
pageNo
number
true
返回分页数量
pageSize
number
true
单页返回数量
searchKey
string
false
代币的 typehash，查询此代币相关的资金池
sort
Enum
false
返回数据的排序方式： "aes"/"desc”
orderBy
Enum
false
排序字段： "tvl"/"dayTxsCount"/"dayVolume"/"dayApr”
poolTypeHashes
array
false
资金池的 typehash，查询指定资金池
Response
code
number
code 0, success
message
string
message success
data
object
output data
output data
ParametersTypeDetailstotalCount
number
查询资金池列表总数
list
PoolList[]
资金池列表
PoolList[]
ParametersTypeDetailsfeeRate
number
资金池费率
batchId
number
资金池交易队列的 nonce
assetX
TokenAsset[]
资金池中 tokenX 对象
assetY
TokenAsset[]
资金池中 tokenY 对象
basedAsset
Enum
基础代币（目前将 CKB，BTC 作为基础代币） 0: tokenX 是基础代币 1: tokenY 是基础代币
totalLpSupply
string
总 LP 代币数量
protocolLpAmount
string
协议中的 LP 代币数量
typeHash
string
资金池的 typehash
tvl
string
当前 TVL
tvlChangeRate
string
24H TVL 变化
dayTxsCount
string
24H 交易笔数
dayVolume
string
24H 交易量
dayVolumeChangeRate
string
24H 交易量变化
dayApr
string
资金池年化利率
dayFees
string
24H 手续费
TokenAsset[]
ParametersTypeDetailslogo
number
-
decimals
string
-
name
string
-
symbol
symbol
-
typeHash
string
-
typeScript
TypeScript[]
-
typeCellDep
TypeCellDep[]
-
isWhiteList
boolean
是否是认证的 token
reserve
string
token 在资金池中的数量
price
string
token 最新的 USD 价格
TypeScript[]
ParametersTypeDetailsargs
string
-
codeHash
string
-
hashType
string
-
TypeCellDep[]
ParametersTypeDetailsoutPoint
OutPoint[]
-
depType
string
-
OutPoint[]
ParametersTypeDetailstxHash
number
-
index
string
-
示例
查询所有资金池
// query all pools
curl --location 'https://utxoswap.xyz/utxo-swap/api/v1/sequencer/pools' \
--header 'x-api-key: {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"pageNo": 0,
"pageSize": 10
}'
// response
{
"code": 0,
"message": "success",
"data": {
"totalCount": 36,
"list": [
{
"feeRate": 30,
"batchId": 330,
"assetX": {
"logo": "https://storage.utxoswap.xyz/images/ckb.png",
"decimals": 8,
"name": "CKB",
"symbol": "CKB",
"typeHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"typeScript": null,
"typeCellDep": null,
"isWhiteList": true,
"reserve": "1449661376047291",
"price": "0.0141799561893442" // token price
},
"assetY": {
"logo": "https://xudtlogos.cc/logos/rusd-logo.png",
"decimals": 8,
"name": "RUSD",
"symbol": "RUSD",
"typeHash": "0x71ff665b40ba044b1981ea9a8965189559c8e01e8cdfa34a3cc565e1f870a95c",
"typeScript": {
"args": "0x360c9d87b2824c357958c23e8878f686001e88e9527a08ea229e7d9ba7fe39a7",
"codeHash": "0x26a33e0815888a4a0614a0b7d09fa951e0993ff21e55905510104a0b1312032b",
"hashType": "type"
},
"typeCellDep": {
"outPoint": {
"txHash": "0xc07844ce21b38e4b071dd0e1ee3b0e27afd8d7532491327f39b786343f558ab7",
"index": 0
},
"depType": "code"
},
"isWhiteList": false,
"reserve": "20276414100987",
"price": "1.0137953732526303940680088183" // token price
},
"basedAsset": 0,
"totalLpSupply": "171351736326047",
"protocolLpAmount": "20324714214",
"typeHash": "0xf6808f0469c0834edf88744574c159d06ff1e1e7a3f39482799dc454952dda3b",
"tvl": "411122.696034700",
"tvlChangeRate": "-0.0033",
"dayTxsCount": "45",
"dayVolume": "5823.484166303",
"dayVolumeChangeRate": "-0.3876",
"dayApr": "0.010857344",
"dayFees": "12.22931674923630"
}
]
}
}查询 Seal 代币相关的资金池
// query seal pools info
curl --location 'https://utxoswap.xyz/utxo-swap/api/v1/sequencer/pools' \
--header 'x-api-key: {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"pageNo": 0,
"pageSize": 10,
"searchKey": "0x178fb47b597a56d48b549226aff59f750b4784250c7f40f781b64ef090a8a0a7",
"sort":"desc",
"orderBy":"tvl"
}'
// response
{
"code": 0,
"message": "success",
"data": {
"totalCount": 2,
"list": [
{
"feeRate": 30,
"batchId": 43125,
"assetX": {
"logo": "https://storage.utxoswap.xyz/images/ckb.png",
"decimals": 8,
"name": "CKB",
"symbol": "CKB",
"typeHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"typeScript": null,
"typeCellDep": null,
"isWhiteList": true,
"reserve": "297846773216181",
"price": "0.0141799561893442" // price of ckb
},
"assetY": {
"logo": "https://xudtlogos.cc/logos/seal-logo.png",
"decimals": 8,
"name": "Seal",
"symbol": "Seal",
"typeHash": "0x178fb47b597a56d48b549226aff59f750b4784250c7f40f781b64ef090a8a0a7",
"typeScript": {
"args": "0x2ae639d6233f9b15545573b8e78f38ff7aa6c7bf8ef6460bf1f12d0a76c09c4e",
"codeHash": "0x50bd8d6680b8b9cf98b73f3c08faf8b2a21914311954118ad6609be6e78a1b95",
"hashType": "data1"
},
"typeCellDep": {
"outPoint": {
"txHash": "0xc07844ce21b38e4b071dd0e1ee3b0e27afd8d7532491327f39b786343f558ab7",
"index": 0
},
"depType": "code"
},
"isWhiteList": false,
"reserve": "13662757627398",
"price": "0.3091216510255344843736102511" // price of seal
},
"basedAsset": 0,
"totalLpSupply": "60686495150999",
"protocolLpAmount": "2365542832003",
"typeHash": "0x29273406698f36e9bdf46db404176859b0ba3a6bdf7025833f7fd3b49150609a",
"tvl": "84469.083906860",
"tvlChangeRate": "-0.0339",
"dayTxsCount": "342",
"dayVolume": "22507.871302284",
"dayVolumeChangeRate": "2.7289",
"dayApr": "0.204243761",
"dayFees": "47.26652973479640"
},
{
"feeRate": 30,
"batchId": 11,
"assetX": {
"logo": "https://xudtlogos.cc/logos/seal-logo.png",
"decimals": 8,
"name": "Seal",
"symbol": "Seal",
"typeHash": "0x178fb47b597a56d48b549226aff59f750b4784250c7f40f781b64ef090a8a0a7",
"typeScript": {
"args": "0x2ae639d6233f9b15545573b8e78f38ff7aa6c7bf8ef6460bf1f12d0a76c09c4e",
"codeHash": "0x50bd8d6680b8b9cf98b73f3c08faf8b2a21914311954118ad6609be6e78a1b95",
"hashType": "data1"
},
"typeCellDep": {
"outPoint": {
"txHash": "0xc07844ce21b38e4b071dd0e1ee3b0e27afd8d7532491327f39b786343f558ab7",
"index": 0
},
"depType": "code"
},
"isWhiteList": false,
"reserve": "1381607763",
"price": "0.0069253393287326375568430871" // price of seal
},
"assetY": {
"logo": "https://xudtlogos.cc/logos/ccbtc-logo.png",
"decimals": 8,
"name": "ccBTC",
"symbol": "BTC",
"typeHash": "0x3cd44aecea36e0a27e671f1fc79e65add7bf2f0e8b368389dc810ec81c63fa57",
"typeScript": {
"args": "0x68e64ba4b0daeeec45c1f983d6d574fca370442cafb805bc4265ef74870a4ac8",
"codeHash": "0x092c2c4a26ea475a8e860c29cf00502103add677705e2ccd8d6fe5af3caa5ae3",
"hashType": "type"
},
"typeCellDep": {
"outPoint": {
"txHash": "0xc07844ce21b38e4b071dd0e1ee3b0e27afd8d7532491327f39b786343f558ab7",
"index": 0
},
"depType": "code"
},
"isWhiteList": true,
"reserve": "142",
"price": "67381.0040703255" // price of btc
},
"basedAsset": 1,
"totalLpSupply": "203882",
"protocolLpAmount": "73",
"typeHash": "0x4706eeef69b314d7681aa3c299c963d7e7fbb54681cd3171b5d678c63c45c05e",
"tvl": "0.191362052",
"tvlChangeRate": "0.0038",
"dayTxsCount": "0",
"dayVolume": "0.000000000",
"dayVolumeChangeRate": null,
"dayApr": "0.000000000",
"dayFees": "0"
}
]
}
}Last updated