Skip to main content
GET
/
v1
/
token
/
{chain}
/
list
Token - List (Filtered)
curl --request GET \
  --url https://api.chainstream.io/v1/token/{chain}/list \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "chain": "solana",
      "decimals": 9,
      "name": "USD Coin",
      "symbol": "USDC",
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "marketData": {
        "totalSupply": "1000000",
        "marketCapInUsd": "100000",
        "holders": "1000",
        "priceInUsd": "0.00000261383847574915906643405542",
        "totalTvlInSol": "0.00000261383847574915906643405542",
        "totalTvlInUsd": "0.00000261383847574915906643405542",
        "marketCapInSol": "100000",
        "top10TotalHoldings": "100000",
        "top10HoldingsRatio": "0.1",
        "top100TotalHoldings": "500000",
        "top100HoldingsRatio": "0.5",
        "priceInSol": "0.00000261383847574915906643405542",
        "maxPoolTvlInSol": "0.00000261383847574915906643405542",
        "maxPoolTvlInUsd": "0.00000261383847574915906643405542",
        "completionRatio": "0.1",
        "top50TotalHoldings": "300000",
        "top50HoldingsRatio": "0.3",
        "bluechipTotalHolders": "10",
        "bluechipTotalHoldings": "50000",
        "bluechipHoldingsRatio": "0.05",
        "kolTotalHolders": "20",
        "kolTotalHoldings": "30000",
        "kolHoldingsRatio": "0.03",
        "sniperTotalHolders": "15",
        "sniperTotalHoldings": "25000",
        "sniperHoldingsRatio": "0.025",
        "proTotalHolders": "25",
        "proTotalHoldings": "40000",
        "proHoldingsRatio": "0.04",
        "insiderTotalHolders": "5",
        "insiderTotalHoldings": "20000",
        "insiderHoldingsRatio": "0.02",
        "sandwishTotalHolders": "8",
        "sandwishTotalHoldings": "15000",
        "sandwishHoldingsRatio": "0.015",
        "freshTotalHolders": "30",
        "freshTotalHoldings": "10000",
        "freshHoldingsRatio": "0.01",
        "bundleTotalHolders": "12",
        "bundleTotalHoldings": "18000",
        "bundleHoldingsRatio": "0.018",
        "devTotalHolders": "3",
        "devTotalHoldings": "5000",
        "devHoldingsRatio": "0.005"
      },
      "metadataAddress": "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s",
      "tokenCreators": [
        {
          "address": "5e2qRc1DNEXmyxP8qwPwJhRWjef7usLyi7v5xjqLr5G7",
          "share": 100,
          "isVerified": true
        }
      ],
      "imageUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
      "uri": "https://...",
      "extra": {
        "collectionAddress": "ABCDE",
        "editionNonce": 1,
        "fungible": true,
        "isMutable": true,
        "key": "Mint",
        "isNative": false,
        "primarySaleHappened": false,
        "launchFromProgramAddress": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
        "launchFromProtocolFamily": "pumpfun",
        "programAddress": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        "migratedToProgramAddress": "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA",
        "migratedToProtocolFamily": "Raydium",
        "migratedToPoolAddress": "7AvUMqLBou5EAXzyhnizWmPU13u2VguJoBYdcX4bhJtQ",
        "migratedAt": 1714857600000,
        "sellerFeeBasisPoints": 100,
        "tokenStandard": "Fungible",
        "mintAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
        "freezeAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
        "updateAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
        "isVerifiedCollection": true,
        "isWrapped": false
      },
      "socialMedias": {
        "twitter": "@circle",
        "telegram": "https://t.me/circle",
        "website": "https://www.circle.com",
        "tiktok": "@circle",
        "discord": "https://discord.gg/circle",
        "facebook": "https://facebook.com/circle",
        "github": "https://github.com/circle",
        "instagram": "@circle",
        "linkedin": "https://linkedin.com/company/circle",
        "medium": "https://medium.com/@circle",
        "reddit": "https://reddit.com/r/circle",
        "youtube": "https://youtube.com/@circle",
        "bitbucket": "https://bitbucket.org/circle"
      },
      "tokenCreatedAt": 1710417600000,
      "tokenCreatedSlot": "230000000",
      "tokenCreatedBlockHeight": "220000000",
      "tokenCreatedTxSignature": "5dJ1BxPiFT7w7aBdkxNy2jopGZnZoLwRwS8e9GkEXrVz...",
      "description": "USDC is a stablecoin pegged to the US dollar",
      "coingeckoCoinId": "usd-coin",
      "devTotalTokens": "163",
      "devLastTokenCreatedAt": "2025-12-03T09:23:34.000Z",
      "market": "USDC-SOL",
      "extension": {
        "website": "https://www.circle.com/usdc",
        "twitter": "@circle"
      },
      "stats": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "periods": {
          "1h": {
            "buys": "1520",
            "sells": "980",
            "trades": "2500",
            "buyers": "320",
            "sellers": "210",
            "traders": "530",
            "buyVolume": "15000000.12345678",
            "buyVolumeInUsd": "45000.00",
            "buyVolumeInNative": "750.50",
            "sellVolume": "12000000.98765432",
            "sellVolumeInUsd": "36000.00",
            "sellVolumeInNative": "600.40",
            "totalVolumeInUsd": "81000.00",
            "totalVolumeInNative": "1350.90",
            "openInUsd": "0.15000000",
            "closeInUsd": "0.15600000",
            "highInUsd": "0.15900000",
            "lowInUsd": "0.15000000",
            "openInNative": "0.00005000",
            "closeInNative": "0.00005200",
            "highInNative": "0.00005300",
            "lowInNative": "0.00005000",
            "averagePriceInUsd": "0.15300000",
            "averagePriceInNative": "0.00005100",
            "priceChangeRatioInUsd": "0.04000000",
            "prevBuys": "1400",
            "prevSells": "900",
            "prevTrades": "2300",
            "prevBuyers": "300",
            "prevSellers": "200",
            "prevBuyVolume": "14000000.00",
            "prevSellVolume": "11000000.00",
            "prevBuyVolumeInUsd": "42000.00",
            "prevSellVolumeInUsd": "33000.00",
            "prevBuyVolumeInNative": "700.00",
            "prevSellVolumeInNative": "550.00",
            "prevOpenInUsd": "0.14800000",
            "prevCloseInUsd": "0.15100000",
            "prevHighInUsd": "0.15200000",
            "prevLowInUsd": "0.14500000",
            "prevOpenInNative": "0.00004900",
            "prevCloseInNative": "0.00005100",
            "prevHighInNative": "0.00005100",
            "prevLowInNative": "0.00004800",
            "dappProgramCount": "8",
            "prevDappProgramCount": "7",
            "poolCount": "12",
            "prevPoolCount": "10",
            "currentLiquidityInUsd": "250000.00",
            "prevLiquidityInUsd": "240000.00",
            "volumeChangeRatio": "0.08",
            "liquidityChangeRatio": "0.0417",
            "buySellRatio": "1.5510",
            "updatedAt": "2026-02-09T08:05:12.345Z"
          }
        }
      },
      "liquidity": [
        {
          "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

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
sort
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
sortBy
enum<string>

Sort by field

Available options:
h24VolumeInUsd,
h24PriceChangeRatio,
h24Buys,
h24Sells,
h24Trades,
h24Buyers,
h24Sellers,
h24BuyVolumeInUsd,
h24SellVolumeInUsd,
h4VolumeInUsd,
h4PriceChangeRatio,
h4Buys,
h4Sells,
h4Trades,
h4Buyers,
h4Sellers,
h4BuyVolumeInUsd,
h4SellVolumeInUsd,
h1VolumeInUsd,
h1PriceChangeRatio,
h1Buys,
h1Sells,
h1Trades,
h1Buyers,
h1Sellers,
h1BuyVolumeInUsd,
h1SellVolumeInUsd,
m30VolumeInUsd,
m30PriceChangeRatio,
m30Buys,
m30Sells,
m30Trades,
m30Buyers,
m30Sellers,
m30BuyVolumeInUsd,
m30SellVolumeInUsd,
m15VolumeInUsd,
m15PriceChangeRatio,
m15Buys,
m15Sells,
m15Trades,
m15Buyers,
m15Sellers,
m15BuyVolumeInUsd,
m15SellVolumeInUsd,
m5VolumeInUsd,
m5PriceChangeRatio,
m5Buys,
m5Sells,
m5Trades,
m5Buyers,
m5Sellers,
m5BuyVolumeInUsd,
m5SellVolumeInUsd,
m1VolumeInUsd,
m1PriceChangeRatio,
m1Buys,
m1Sells,
m1Trades,
m1Buyers,
m1Sellers,
m1BuyVolumeInUsd,
m1SellVolumeInUsd
Example:

"h24VolumeInUsd"

min_h24_volume_in_usd
string

Minimum 24h volume in USD

max_h24_volume_in_usd
string

Maximum 24h volume in USD

min_h24_price_change_ratio
string

Minimum 24h price change ratio

max_h24_price_change_ratio
string

Maximum 24h price change ratio

min_h24_buys
string

Minimum 24h buys

max_h24_buys
string

Maximum 24h buys

min_h24_sells
string

Minimum 24h sells

max_h24_sells
string

Maximum 24h sells

min_h24_trades
string

Minimum 24h trades

max_h24_trades
string

Maximum 24h trades

min_h24_buyers
string

Minimum 24h buyers

max_h24_buyers
string

Maximum 24h buyers

min_h24_sellers
string

Minimum 24h sellers

max_h24_sellers
string

Maximum 24h sellers

min_h24_buy_volume_in_usd
string

Minimum 24h buy volume in USD

max_h24_buy_volume_in_usd
string

Maximum 24h buy volume in USD

min_h24_sell_volume_in_usd
string

Minimum 24h sell volume in USD

max_h24_sell_volume_in_usd
string

Maximum 24h sell volume in USD

min_h4_volume_in_usd
string

Minimum 4h volume in USD

max_h4_volume_in_usd
string

Maximum 4h volume in USD

min_h4_price_change_ratio
string

Minimum 4h price change ratio

max_h4_price_change_ratio
string

Maximum 4h price change ratio

min_h4_buys
string

Minimum 4h buys

max_h4_buys
string

Maximum 4h buys

min_h4_sells
string

Minimum 4h sells

max_h4_sells
string

Maximum 4h sells

min_h4_trades
string

Minimum 4h trades

max_h4_trades
string

Maximum 4h trades

min_h4_buyers
string

Minimum 4h buyers

max_h4_buyers
string

Maximum 4h buyers

min_h4_sellers
string

Minimum 4h sellers

max_h4_sellers
string

Maximum 4h sellers

min_h4_buy_volume_in_usd
string

Minimum 4h buy volume in USD

max_h4_buy_volume_in_usd
string

Maximum 4h buy volume in USD

min_h4_sell_volume_in_usd
string

Minimum 4h sell volume in USD

max_h4_sell_volume_in_usd
string

Maximum 4h sell volume in USD

min_h1_volume_in_usd
string

Minimum 1h volume in USD

max_h1_volume_in_usd
string

Maximum 1h volume in USD

min_h1_price_change_ratio
string

Minimum 1h price change ratio

max_h1_price_change_ratio
string

Maximum 1h price change ratio

min_h1_buys
string

Minimum 1h buys

max_h1_buys
string

Maximum 1h buys

min_h1_sells
string

Minimum 1h sells

max_h1_sells
string

Maximum 1h sells

min_h1_trades
string

Minimum 1h trades

max_h1_trades
string

Maximum 1h trades

min_h1_buyers
string

Minimum 1h buyers

max_h1_buyers
string

Maximum 1h buyers

min_h1_sellers
string

Minimum 1h sellers

max_h1_sellers
string

Maximum 1h sellers

min_h1_buy_volume_in_usd
string

Minimum 1h buy volume in USD

max_h1_buy_volume_in_usd
string

Maximum 1h buy volume in USD

min_h1_sell_volume_in_usd
string

Minimum 1h sell volume in USD

max_h1_sell_volume_in_usd
string

Maximum 1h sell volume in USD

min_m30_volume_in_usd
string

Minimum 30m volume in USD

max_m30_volume_in_usd
string

Maximum 30m volume in USD

min_m30_price_change_ratio
string

Minimum 30m price change ratio

max_m30_price_change_ratio
string

Maximum 30m price change ratio

min_m30_buys
string

Minimum 30m buys

max_m30_buys
string

Maximum 30m buys

min_m30_sells
string

Minimum 30m sells

max_m30_sells
string

Maximum 30m sells

min_m30_trades
string

Minimum 30m trades

max_m30_trades
string

Maximum 30m trades

min_m30_buyers
string

Minimum 30m buyers

max_m30_buyers
string

Maximum 30m buyers

min_m30_sellers
string

Minimum 30m sellers

max_m30_sellers
string

Maximum 30m sellers

min_m30_buy_volume_in_usd
string

Minimum 30m buy volume in USD

max_m30_buy_volume_in_usd
string

Maximum 30m buy volume in USD

min_m30_sell_volume_in_usd
string

Minimum 30m sell volume in USD

max_m30_sell_volume_in_usd
string

Maximum 30m sell volume in USD

min_m15_volume_in_usd
string

Minimum 15m volume in USD

max_m15_volume_in_usd
string

Maximum 15m volume in USD

min_m15_price_change_ratio
string

Minimum 15m price change ratio

max_m15_price_change_ratio
string

Maximum 15m price change ratio

min_m15_buys
string

Minimum 15m buys

max_m15_buys
string

Maximum 15m buys

min_m15_sells
string

Minimum 15m sells

max_m15_sells
string

Maximum 15m sells

min_m15_trades
string

Minimum 15m trades

max_m15_trades
string

Maximum 15m trades

min_m15_buyers
string

Minimum 15m buyers

max_m15_buyers
string

Maximum 15m buyers

min_m15_sellers
string

Minimum 15m sellers

max_m15_sellers
string

Maximum 15m sellers

min_m15_buy_volume_in_usd
string

Minimum 15m buy volume in USD

max_m15_buy_volume_in_usd
string

Maximum 15m buy volume in USD

min_m15_sell_volume_in_usd
string

Minimum 15m sell volume in USD

max_m15_sell_volume_in_usd
string

Maximum 15m sell volume in USD

min_m5_volume_in_usd
string

Minimum 5m volume in USD

max_m5_volume_in_usd
string

Maximum 5m volume in USD

min_m5_price_change_ratio
string

Minimum 5m price change ratio

max_m5_price_change_ratio
string

Maximum 5m price change ratio

min_m5_buys
string

Minimum 5m buys

max_m5_buys
string

Maximum 5m buys

min_m5_sells
string

Minimum 5m sells

max_m5_sells
string

Maximum 5m sells

min_m5_trades
string

Minimum 5m trades

max_m5_trades
string

Maximum 5m trades

min_m5_buyers
string

Minimum 5m buyers

max_m5_buyers
string

Maximum 5m buyers

min_m5_sellers
string

Minimum 5m sellers

max_m5_sellers
string

Maximum 5m sellers

min_m5_buy_volume_in_usd
string

Minimum 5m buy volume in USD

max_m5_buy_volume_in_usd
string

Maximum 5m buy volume in USD

min_m5_sell_volume_in_usd
string

Minimum 5m sell volume in USD

max_m5_sell_volume_in_usd
string

Maximum 5m sell volume in USD

min_m1_volume_in_usd
string

Minimum 1m volume in USD

max_m1_volume_in_usd
string

Maximum 1m volume in USD

min_m1_price_change_ratio
string

Minimum 1m price change ratio

max_m1_price_change_ratio
string

Maximum 1m price change ratio

min_m1_buys
string

Minimum 1m buys

max_m1_buys
string

Maximum 1m buys

min_m1_sells
string

Minimum 1m sells

max_m1_sells
string

Maximum 1m sells

min_m1_trades
string

Minimum 1m trades

max_m1_trades
string

Maximum 1m trades

min_m1_buyers
string

Minimum 1m buyers

max_m1_buyers
string

Maximum 1m buyers

min_m1_sellers
string

Minimum 1m sellers

max_m1_sellers
string

Maximum 1m sellers

min_m1_buy_volume_in_usd
string

Minimum 1m buy volume in USD

max_m1_buy_volume_in_usd
string

Maximum 1m buy volume in USD

min_m1_sell_volume_in_usd
string

Minimum 1m sell volume in USD

max_m1_sell_volume_in_usd
string

Maximum 1m sell volume in USD

Response

200 - application/json
data
object[]
required

Array of token 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