Skip to main content
GET
/
v1
/
token
/
{chain}
/
{tokenAddress}
/
pools
Token - Liquidity
curl --request GET \
  --url https://api.chainstream.io/v1/token/{chain}/{tokenAddress}/pools \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "chain": "sol",
      "poolAddress": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
      "tokenAAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "tokenBAddress": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "programAddress": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
      "protocolFamily": "OrcaWhirpool",
      "image": "https://ipfs.io/ipfs/bafkreid7667676767676767676767676767676767676767676767676767676767676767",
      "protocolName": "OrcaWhirpool AMM V2",
      "tvlInUsd": "1000000.45",
      "tvlInSol": "1000000.45",
      "type": 1,
      "version": 2,
      "liquidityModel": 1,
      "feeRate": "0.003",
      "tickSpacing": 64,
      "tokenCount": 2,
      "createdBlockTimestamp": "2024-01-15T10:30:00Z",
      "tokenALiquidity": {
        "tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "decimals": 6,
        "vaultAmount": "1000000000000",
        "amountInUsd": "1000000.45",
        "amountInNative": "5000.123",
        "priceUsd": "1.0001",
        "priceNative": "0.005"
      },
      "tokenBLiquidity": {
        "tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "decimals": 6,
        "vaultAmount": "1000000000000",
        "amountInUsd": "1000000.45",
        "amountInNative": "5000.123",
        "priceUsd": "1.0001",
        "priceNative": "0.005"
      }
    }
  ],
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "<string>",
  "endCursor": "<string>",
  "total": 0
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

chain
enum<string>
required

A chain name listed in supported networks

Available options:
sol,
bsc,
eth
tokenAddress
string
required

An address of a token

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

Query Parameters

cursor
string

Pagination cursor

limit
integer<int64>
default:20

Number of results per page

Required range: 1 <= x <= 100
direction
enum<string>
default:next

Pagination direction (next or prev)

Available options:
next,
prev
sortBy
enum<string>
default:tvlInUsd

Sort field (tvlInSol or tvlInUsd)

Available options:
tvlInSol,
tvlInUsd
Example:

"tvlInUsd"

sortDirection
enum<string>
default:desc

Sort direction (asc or desc)

Available options:
asc,
desc
minTvlInSol
string

Minimum TVL in SOL

Example:

"100"

maxTvlInSol
string

Maximum TVL in SOL

Example:

"10000"

minTvlInUsd
string

Minimum TVL in USD

Example:

"1000"

maxTvlInUsd
string

Maximum TVL in USD

Example:

"100000"

Response

200 - application/json
data
object[]
required

Array of DEX pool data

hasNext
boolean
default:false

Indicates if there are more results

hasPrev
boolean
default:false

Indicates if there are previous results

startCursor
string

Cursor for first item in current page

endCursor
string

Cursor for last item in current page

total
integer<int64>
default:0

Total number of items