토큰 - 상세

토큰 상세 정보 조회

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

토큰 - 상세

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"
}

메타데이터, 통계, 시장 데이터를 포함한 토큰의 종합적인 정보를 반환합니다. 기본 토큰 조회 엔드포인트로 사용하세요.

관련: GraphQL TokenSearch Cube | MCP: token_get

인증

bearer_authapi_key_auth

Authorization · string · header · 필수

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

경로 매개변수

chain · enum<string> · 필수

지원되는 네트워크에 나열된 체인 이름 지원되는 블록체인

사용 가능한 옵션: sol, eth, bsc

tokenAddress · string · 필수

토큰 주소

응답

200 - application/json

조회

토큰 엔티티 — TS TokenDTO extends TokenMetadataDTO와 일치.

TS는 클래스 상속으로 메타데이터를 최상위로 평탄화합니다. Rust는 #[serde(flatten)]로 동일한 효과를 얻습니다.

address · string · 필수

토큰 컨트랙트 주소

예시:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

chain · string · 필수

블록체인 네트워크 식별자

예시:

"sol"

decimals · integer<int32> · 필수

소수점 자릿수

예시:

9

name · string · 필수

토큰 표시 이름

예시:

"USD Coin"

symbol · string · 필수

토큰 티커 심볼

예시:

"USDC"

coingeckoCoinId · string | null

CoinGecko 코인 식별자

예시:

"usd-coin"

description · string | null

토큰 설명

예시:

"USDC is a stablecoin pegged to the US dollar"

devLastTokenCreatedAt · string | null

개발자의 마지막 토큰 생성 타임스탬프

예시:

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

devTotalTokens · string | null

개발자가 생성한 총 토큰 수

예시:

"163"

extension · object

ENTITY.TOKEN.EXTENSION ENTITY.TOKEN.EXTENSION

Show child attributes

extra · object

확장 토큰 메타데이터

Show child attributes

imageUrl · string | null

토큰 로고 이미지 URL

예시:

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

market · string | null

거래 마켓 식별자

예시:

"USDC-SOL"

marketData · object

시장 데이터

Show child attributes

metadataAddress · string | null

온체인 메타데이터 계정 주소

예시:

"metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s"

socialMedias · object

토큰 소셜 미디어 링크

Show child attributes

stats · object

토큰 통계

Show child attributes

tokenCreatedAt · integer<int64> | null

토큰 생성 타임스탬프 (밀리초)

예시:

1710417600000

tokenCreatedBlockHeight · string | null

토큰이 생성된 블록 높이

예시:

"220000000"

tokenCreatedSlot · string | null

토큰이 생성된 슬롯 번호

예시:

"230000000"

tokenCreatedTxSignature · string | null

토큰 생성 트랜잭션 서명

예시:

"5dJ1BxPiFT7w7aBdkxNy2jopGZnZoLwRwS8e9GkEXrVz..."

tokenCreators · object[]

토큰 생성자 목록

Show child attributes

uri · string | null

토큰 메타데이터 URI

예시:

"https://arweave.net/abc123"