Skip to main content
GET
/
v1
/
token
/
{chain}
/
{tokenAddress}
Token - Detail
curl --request GET \
  --url https://api.chainstream.io/v1/token/{chain}/{tokenAddress} \
  --header 'Authorization: Bearer <token>'
{
  "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"
      }
    }
  ]
}

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"

Response

200 - application/json
​
chain
string
required

Blockchain network identifier

Example:

"solana"

​
decimals
integer<int64>
required

Token decimals

Example:

9

​
name
string
required

Token name

Example:

"USD Coin"

​
symbol
string
required

Token symbol

Example:

"USDC"

​
address
string
required

Token mint address

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

​
marketData
object
required

Market cap

​
metadataAddress
string

Metadata program address

Example:

"metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s"

​
tokenCreators
object[]

Token creator addresses

​
imageUrl
string

Token image URL

Example:

"https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png"

​
uri
string

Metadata URI

Example:

"https://..."

​
extra
object

Additional metadata

​
socialMedias
object

Social media links

​
tokenCreatedAt
integer<int64>

Token creation timestamp

Example:

1710417600000

​
tokenCreatedSlot
string

Block slot number when the token was created

Example:

"230000000"

​
tokenCreatedBlockHeight
string

Block height when the token was created

Example:

"220000000"

​
tokenCreatedTxSignature
string

Transaction signature/hash of the token creation

Example:

"5dJ1BxPiFT7w7aBdkxNy2jopGZnZoLwRwS8e9GkEXrVz..."

​
description
string

Token description

Example:

"USDC is a stablecoin pegged to the US dollar"

​
coingeckoCoinId
string

CoinGecko coin identifier

Example:

"usd-coin"

​
devTotalTokens
string

Total number of tokens created by dev

Example:

"163"

​
devLastTokenCreatedAt
string

Timestamp of the last token created by dev

Example:

"2025-12-03T09:23:34.000Z"

​
market
string

Market identifier

Example:

"USDC-SOL"

​
extension
object

Additional token metadata

Example:
{
  "website": "https://www.circle.com/usdc",
  "twitter": "@circle"
}
​
stats
object

Token stats

​
liquidity
object[]

Liquidity