跳转到主要内容
GET
/
v1
/
token
/
search
代币 - 搜索
curl --request GET \
  --url https://api.chainstream.io/v1/token/search \
  --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,
  "countsByProtocols": {
    "uniswap": 500,
    "sushiswap": 300
  }
}

授权

Authorization
string
header
必填

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

查询参数

cursor
string

分页游标

limit
integer<int64>
默认值:20

每页结果数量

必填范围: 1 <= x <= 100
direction
enum<string>
默认值:next

分页方向(next或prev)

可用选项:
next,
prev
chains
string[]

链筛选

q
string

代币名称、符号或地址的搜索查询字符串

Minimum string length: 1
示例:

"USDC"

sort
enum<string>
默认值:desc

排序方向

可用选项:
asc,
desc
protocols
string[]

协议筛选,具体支持协议请查看Dex - 列表返回的dexName值

sortBy
enum<string>

排序字段

可用选项:
marketCapInUsd,
liquidityInUsd,
priceInUsd,
holderCount,
h24VolumeInUsd,
h24Transactions,
tokenCreatedAt
示例:

"priceInUsd"

响应

200 - application/json
data
object[]
必填

代币数据数组

hasNext
boolean
默认值:false

指示是否有更多结果

hasPrev
boolean
默认值:false

指示是否有上一页结果

startCursor
string

当前页第一项的游标

endCursor
string

当前页最后一项的游标

total
integer<int64>
默认值:0

总项目数

countsByProtocols
object

按协议统计的代币数量

示例:
{ "uniswap": 500, "sushiswap": 300 }