Token - Detail

Get detail of token

GET /v2/token/{chain}/{tokenAddress}

Token - Detail

cURL

curl --request GET \
  --url https://api.chainstream.io/v2/token/{chain}/{tokenAddress} \
  --header 'Authorization: Bearer <token>'

200

{
  "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "chain": "sol",
  "decimals": 9,
  "name": "USD Coin",
  "symbol": "USDC",
  "coingeckoCoinId": "usd-coin",
  "description": "USDC is a stablecoin pegged to the US dollar",
  "devLastTokenCreatedAt": "2025-12-03T09:23:34.000Z",
  "devTotalTokens": "163",
  "extension": {
    "collectionAddress": "ABCDE",
    "editionNonce": 1,
    "freezeAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
    "fungible": true,
    "isMutable": true,
    "isNative": false,
    "isVerifiedCollection": true,
    "isWrapped": false,
    "key": "Mint",
    "launchFromProgramAddress": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
    "launchFromProtocolFamily": "pumpfun",
    "migratedAt": 1714857600000,
    "migratedToPoolAddress": "7AvUMqLBou5EAXzyhnizWmPU13u2VguJoBYdcX4bhJtQ",
    "migratedToProgramAddress": "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA",
    "migratedToProtocolFamily": "Raydium",
    "mintAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
    "primarySaleHappened": false,
    "programAddress": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "sellerFeeBasisPoints": 100,
    "tokenStandard": "Fungible",
    "updateAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV"
  },
  "extra": {
    "collectionAddress": "ABCDE",
    "editionNonce": 1,
    "freezeAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
    "fungible": true,
    "isMutable": true,
    "isNative": false,
    "isVerifiedCollection": true,
    "isWrapped": false,
    "key": "Mint",
    "launchFromProgramAddress": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
    "launchFromProtocolFamily": "pumpfun",
    "migratedAt": 1714857600000,
    "migratedToPoolAddress": "7AvUMqLBou5EAXzyhnizWmPU13u2VguJoBYdcX4bhJtQ",
    "migratedToProgramAddress": "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA",
    "migratedToProtocolFamily": "Raydium",
    "mintAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
    "primarySaleHappened": false,
    "programAddress": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "sellerFeeBasisPoints": 100,
    "tokenStandard": "Fungible",
    "updateAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV"
  },
  "imageUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
  "market": "USDC-SOL",
  "marketData": {
    "bluechipHoldingsRatio": "0.05",
    "bluechipTotalHolders": "10",
    "bluechipTotalHoldings": "50000",
    "bundleHoldingsRatio": "0.018",
    "bundleTotalHolders": "12",
    "bundleTotalHoldings": "18000",
    "circulatingSupply": "900000",
    "completionRatio": "1.0",
    "devHoldingsRatio": "0.005",
    "devTotalHolders": "3",
    "devTotalHoldings": "5000",
    "fdvInSol": "200000",
    "fdvInUsd": "200000",
    "freshHoldingsRatio": "0.01",
    "freshTotalHolders": "30",
    "freshTotalHoldings": "10000",
    "holders": "1000",
    "insiderHoldingsRatio": "0.02",
    "insiderTotalHolders": "5",
    "insiderTotalHoldings": "20000",
    "kolHoldingsRatio": "0.03",
    "kolTotalHolders": "20",
    "kolTotalHoldings": "30000",
    "marketCapInSol": "100000",
    "marketCapInUsd": "100000",
    "maxPoolTvlInSol": "1000.45",
    "maxPoolTvlInUsd": "150000.00",
    "priceInSol": "0.00000261383847574915906643405542",
    "priceInUsd": "0.00000261383847574915906643405542",
    "proHoldingsRatio": "0.04",
    "proTotalHolders": "25",
    "proTotalHoldings": "40000",
    "sandwishHoldingsRatio": "0.015",
    "sandwishTotalHolders": "8",
    "sandwishTotalHoldings": "15000",
    "sniperHoldingsRatio": "0.025",
    "sniperTotalHolders": "15",
    "sniperTotalHoldings": "25000",
    "top100HoldingsRatio": "0.8",
    "top100TotalHoldings": "800000",
    "top10HoldingsRatio": "0.5",
    "top10TotalHoldings": "500000",
    "top50HoldingsRatio": "0.3",
    "top50TotalHoldings": "300000",
    "totalSupply": "1000000",
    "totalTvlInSol": "1000000.45",
    "totalTvlInUsd": "1000000.45"
  },
  "metadataAddress": "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s",
  "socialMedias": {
    "bitbucket": "https://bitbucket.org/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",
    "telegram": "https://t.me/circle",
    "tiktok": "@circle",
    "twitter": "@circle",
    "website": "https://www.circle.com",
    "youtube": "https://youtube.com/@circle"
  },
  "stats": {
    "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "periods": {
      "24h": {
        "buyVolumeInUsd": "45000.00",
        "buyers": "320",
        "buys": "1520",
        "closeInUsd": "0.15600000",
        "currentLiquidityInUsd": "250000.00",
        "highInUsd": "0.15900000",
        "lowInUsd": "0.15000000",
        "openInUsd": "0.15000000",
        "priceChangeRatioInUsd": "0.04000000",
        "sellVolumeInUsd": "36000.00",
        "sellers": "210",
        "sells": "980",
        "totalVolumeInUsd": "81000.00",
        "traders": "530",
        "trades": "2500"
      }
    }
  },
  "tokenCreatedAt": 1710417600000,
  "tokenCreatedBlockHeight": "220000000",
  "tokenCreatedSlot": "230000000",
  "tokenCreatedTxSignature": "5dJ1BxPiFT7w7aBdkxNy2jopGZnZoLwRwS8e9GkEXrVz...",
  "tokenCreators": [
    {
      "address": "5e2qRc1DNEXmyxP8qwPwJhRWjef7usLyi7v5xjqLr5G7",
      "isVerified": true,
      "share": 100
    }
  ],
  "uri": "https://arweave.net/abc123"
}

Returns comprehensive token information including metadata, stats, and market data. Use this as your primary token lookup endpoint.

Related: GraphQL TokenSearch Cube | MCP: token_get

Authorizations

bearer_authapi_key_auth

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 Supported blockchain chains

Available options: sol, eth, bsc

tokenAddress · string · required

An address of a token

Response

200 - application/json

Get

Token entity — mirrors TS TokenDTO extends TokenMetadataDTO.

TS uses class inheritance to flatten metadata into the top level. Rust uses #[serde(flatten)] for the same effect.

address · string · required

Token contract address

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

chain · string · required

Blockchain network identifier

Example:

"sol"

decimals · integer<int32> · required

Number of decimal places

Example:

9

name · string · required

Token display name

Example:

"USD Coin"

symbol · string · required

Token ticker symbol

Example:

"USDC"

coingeckoCoinId · string | null

CoinGecko coin identifier

Example:

"usd-coin"

description · string | null

Token description

Example:

"USDC is a stablecoin pegged to the US dollar"

devLastTokenCreatedAt · string | null

Timestamp of developer last token creation

Example:

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

devTotalTokens · string | null

Total number of tokens created by the developer

Example:

"163"

extension · object

ENTITY.TOKEN.EXTENSION ENTITY.TOKEN.EXTENSION

Show child attributes

extra · object

Extended token metadata

Show child attributes

imageUrl · string | null

Token logo image URL

Example:

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

market · string | null

Trading market identifier

Example:

"USDC-SOL"

marketData · object

Market data

Show child attributes

metadataAddress · string | null

On-chain metadata account address

Example:

"metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s"

socialMedias · object

Token social media links

Show child attributes

stats · object

Token statistics

Show child attributes

tokenCreatedAt · integer<int64> | null

Token creation timestamp (milliseconds)

Example:

1710417600000

tokenCreatedBlockHeight · string | null

Block height when token was created

Example:

"220000000"

tokenCreatedSlot · string | null

Slot number when token was created

Example:

"230000000"

tokenCreatedTxSignature · string | null

Transaction signature of token creation

Example:

"5dJ1BxPiFT7w7aBdkxNy2jopGZnZoLwRwS8e9GkEXrVz..."

tokenCreators · object[]

List of token creators

Show child attributes

uri · string | null

Token metadata URI

Example:

"https://arweave.net/abc123"