Pools
Last updated
Last updated
Retrieves a liquidity pool by its unique identifier.
The unique identifier of the liquidity pool.
curl -L \
--url 'https://indexer-dev.saturnbtc.io/v0/pool/by-id/{id}'{
"shards": [
{
"pubkey": "text",
"utxo": "text",
"mempoolInfo": {
"ancestorsCount": 1,
"ancestorsSize": 1,
"descendantsCount": 1,
"descendantsSize": 1
},
"pool_pubkey": "text",
"rune_utxo": {
"needs_consolidation": {
"No": {}
},
"utxo": {
"txid": "text",
"vout": 1
},
"value": "text",
"runes": [
{
"id": {
"block": "text",
"tx": 1
},
"amount": "text"
}
],
"status": {
"Pending": {
"total_fee": "text",
"total_size": 1
}
}
},
"btc_utxos": [
{
"needs_consolidation": {
"No": {}
},
"utxo": {
"txid": "text",
"vout": 1
},
"value": "text",
"runes": [
{
"id": {
"block": "text",
"tx": 1
},
"amount": "text"
}
],
"status": {
"Pending": {
"total_fee": "text",
"total_size": 1
}
}
}
],
"liquidity": "text",
"protocol_fee_owed": "text",
"last_block_height": "text",
"times_updated": "text",
"k_last": "text",
"k_last_counter": "text",
"pending_to_send": [
{
"address": "text",
"amount": "text"
}
]
}
],
"config": {
"pubkey": "text",
"fee_tier": 1,
"shards": 1,
"token_0": {
"block": "text",
"tx": 1
},
"token_1": {
"block": "text",
"tx": 1
}
},
"liquidity": "text",
"price": "text",
"token0Amount": "text",
"token1Amount": "text"
}The liquidity pool details with serialized BigInt values.
Retrieves liquidity pools matching the specified token names and optional fee tier.
curl -L \
--url 'https://indexer-dev.saturnbtc.io/v0/pool/by-token-names?token0=text&token1=text'[
{
"shards": [
{
"pubkey": "text",
"utxo": "text",
"mempoolInfo": {
"ancestorsCount": 1,
"ancestorsSize": 1,
"descendantsCount": 1,
"descendantsSize": 1
},
"pool_pubkey": "text",
"rune_utxo": {
"needs_consolidation": {
"No": {}
},
"utxo": {
"txid": "text",
"vout": 1
},
"value": "text",
"runes": [
{
"id": {
"block": "text",
"tx": 1
},
"amount": "text"
}
],
"status": {
"Pending": {
"total_fee": "text",
"total_size": 1
}
}
},
"btc_utxos": [
{
"needs_consolidation": {
"No": {}
},
"utxo": {
"txid": "text",
"vout": 1
},
"value": "text",
"runes": [
{
"id": {
"block": "text",
"tx": 1
},
"amount": "text"
}
],
"status": {
"Pending": {
"total_fee": "text",
"total_size": 1
}
}
}
],
"liquidity": "text",
"protocol_fee_owed": "text",
"last_block_height": "text",
"times_updated": "text",
"k_last": "text",
"k_last_counter": "text",
"pending_to_send": [
{
"address": "text",
"amount": "text"
}
]
}
],
"config": {
"pubkey": "text",
"fee_tier": 1,
"shards": 1,
"token_0": {
"block": "text",
"tx": 1
},
"token_1": {
"block": "text",
"tx": 1
}
},
"liquidity": "text",
"price": "text",
"token0Amount": "text",
"token1Amount": "text"
}
]A list of liquidity pools with serialized BigInt values.
Retrieves liquidity pools matching the specified token IDs and optional fee tier.
curl -L \
--url 'https://indexer-dev.saturnbtc.io/v0/pool/by-token-ids?token0=text&token1=text'[
{
"shards": [
{
"pubkey": "text",
"utxo": "text",
"mempoolInfo": {
"ancestorsCount": 1,
"ancestorsSize": 1,
"descendantsCount": 1,
"descendantsSize": 1
},
"pool_pubkey": "text",
"rune_utxo": {
"needs_consolidation": {
"No": {}
},
"utxo": {
"txid": "text",
"vout": 1
},
"value": "text",
"runes": [
{
"id": {
"block": "text",
"tx": 1
},
"amount": "text"
}
],
"status": {
"Pending": {
"total_fee": "text",
"total_size": 1
}
}
},
"btc_utxos": [
{
"needs_consolidation": {
"No": {}
},
"utxo": {
"txid": "text",
"vout": 1
},
"value": "text",
"runes": [
{
"id": {
"block": "text",
"tx": 1
},
"amount": "text"
}
],
"status": {
"Pending": {
"total_fee": "text",
"total_size": 1
}
}
}
],
"liquidity": "text",
"protocol_fee_owed": "text",
"last_block_height": "text",
"times_updated": "text",
"k_last": "text",
"k_last_counter": "text",
"pending_to_send": [
{
"address": "text",
"amount": "text"
}
]
}
],
"config": {
"pubkey": "text",
"fee_tier": 1,
"shards": 1,
"token_0": {
"block": "text",
"tx": 1
},
"token_1": {
"block": "text",
"tx": 1
}
},
"liquidity": "text",
"price": "text",
"token0Amount": "text",
"token1Amount": "text"
}
]A list of liquidity pools with serialized BigInt values.
Retrieves statistics for multiple pools identified by their IDs.
curl -L \
--url 'https://indexer-dev.saturnbtc.io/v0/pool/stats/by-ids?poolIds=text'[
{
"id": "text",
"tvl_now": "text",
"tvl_24h_ago": "text",
"tvl_diff": "text",
"volume_24h": "text",
"volume_diff_24h": "text",
"fees_24h": "text",
"apy_24h": "text",
"apy": "text",
"volume_7d": "text",
"fees_7d": "text",
"apy_7d": "text",
"price": "text",
"token0Amount": "text",
"token1Amount": "text",
"token0": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": "text",
"tradeable": true,
"verified": true,
"icon": null,
"priority": 1,
"type": null,
"divisibility": 1,
"supply": "text",
"batchSize": "text",
"transactionId": "text",
"createdAt": "text"
},
"token1": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": "text",
"tradeable": true,
"verified": true,
"icon": null,
"priority": 1,
"type": null,
"divisibility": 1,
"supply": "text",
"batchSize": "text",
"transactionId": "text",
"createdAt": "text"
},
"liquidity": "text",
"fee_rate": 1
}
]A list of pool statistics with serialized BigInt values.
Retrieves a paginated list of liquidity pools based on the specified name and sorting options.
curl -L \
--url 'https://indexer-dev.saturnbtc.io/v0/pool?offset=1'{
"response": [
{
"shards": [
{
"pubkey": "text",
"utxo": "text",
"mempoolInfo": {
"ancestorsCount": 1,
"ancestorsSize": 1,
"descendantsCount": 1,
"descendantsSize": 1
},
"pool_pubkey": "text",
"rune_utxo": {
"needs_consolidation": {
"No": {}
},
"utxo": {
"txid": "text",
"vout": 1
},
"value": "text",
"runes": [
{
"id": {
"block": "text",
"tx": 1
},
"amount": "text"
}
],
"status": {
"Pending": {
"total_fee": "text",
"total_size": 1
}
}
},
"btc_utxos": [
{
"needs_consolidation": {
"No": {}
},
"utxo": {
"txid": "text",
"vout": 1
},
"value": "text",
"runes": [
{
"id": {
"block": "text",
"tx": 1
},
"amount": "text"
}
],
"status": {
"Pending": {
"total_fee": "text",
"total_size": 1
}
}
}
],
"liquidity": "text",
"protocol_fee_owed": "text",
"last_block_height": "text",
"times_updated": "text",
"k_last": "text",
"k_last_counter": "text",
"pending_to_send": [
{
"address": "text",
"amount": "text"
}
]
}
],
"config": {
"pubkey": "text",
"fee_tier": 1,
"shards": 1,
"token_0": {
"block": "text",
"tx": 1
},
"token_1": {
"block": "text",
"tx": 1
}
},
"liquidity": "text",
"price": "text",
"token0Amount": "text",
"token1Amount": "text"
}
],
"offset": 1
}A paginated response containing a list of liquidity pools with serialized BigInt values.
Retrieves a paginated list of pool statistics based on provided filters.
curl -L \
--request POST \
--url 'https://indexer-dev.saturnbtc.io/v0/pool/stats/by-filter' \
--header 'Content-Type: application/json' \
--data '{
"name": [
"text"
],
"minTvl": "text",
"minVolume": "text",
"sort": [
{
"field": null,
"order": null
}
],
"limit": 1,
"offset": 1
}'{
"response": [
{
"id": "text",
"tvl_now": "text",
"tvl_24h_ago": "text",
"tvl_diff": "text",
"volume_24h": "text",
"volume_diff_24h": "text",
"fees_24h": "text",
"apy_24h": "text",
"apy": "text",
"volume_7d": "text",
"fees_7d": "text",
"apy_7d": "text",
"price": "text",
"token0Amount": "text",
"token1Amount": "text",
"token0": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": "text",
"tradeable": true,
"verified": true,
"icon": null,
"priority": 1,
"type": null,
"divisibility": 1,
"supply": "text",
"batchSize": "text",
"transactionId": "text",
"createdAt": "text"
},
"token1": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": "text",
"tradeable": true,
"verified": true,
"icon": null,
"priority": 1,
"type": null,
"divisibility": 1,
"supply": "text",
"batchSize": "text",
"transactionId": "text",
"createdAt": "text"
},
"liquidity": "text",
"fee_rate": 1
}
],
"offset": 1
}A paginated response containing a list of pool statistics with serialized BigInt values.
Retrieves a paginated list of pool statistics grouped by tokens based on provided filters.
curl -L \
--request POST \
--url 'https://indexer-dev.saturnbtc.io/v0/pool/stats/by-token-filter' \
--header 'Content-Type: application/json' \
--data '{
"name": [
"text"
],
"minTvl": "text",
"minVolume": "text",
"sort": [
{
"field": null,
"order": null
}
],
"limit": 1,
"offset": 1
}'{
"response": [
{
"token0": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": "text",
"tradeable": true,
"verified": true,
"icon": null,
"priority": 1,
"type": null,
"divisibility": 1,
"supply": "text",
"batchSize": "text",
"transactionId": "text",
"createdAt": "text"
},
"token1": {
"id": "text",
"name": "text",
"displayName": "text",
"symbol": "text",
"tradeable": true,
"verified": true,
"icon": null,
"priority": 1,
"type": null,
"divisibility": 1,
"supply": "text",
"batchSize": "text",
"transactionId": "text",
"createdAt": "text"
},
"volume_24h": "text",
"volume_diff_24h": "text",
"volume_7d": "text",
"fees_24h": "text",
"tvl_now": "text",
"tvl_24h_ago": "text",
"tvl_diff": "text",
"smaller_24h_apy": "text",
"larger_24h_apy": "text",
"smaller_7d_apy": "text",
"larger_7d_apy": "text",
"pools": [
{
"id": "text",
"liquidity": "text",
"price": "text",
"token0Amount": "text",
"token1Amount": "text",
"tvl_now": "text",
"tvl_24h_ago": "text",
"tvl_diff": "text",
"volume_24h": "text",
"volume_diff_24h": "text",
"fees_24h": "text",
"apy_24h": "text",
"apy_7d": "text",
"apy": "text",
"volume_7d": "text",
"fees_7d": "text",
"fee_rate": 1
}
]
}
],
"offset": 1
}A paginated response containing a list of grouped pool statistics with serialized BigInt values.