Skip to main content
GET
/
v2
/
token
/
{chain}
/
{tokenAddress}
/
similar
Token - Similar
curl --request GET \
  --url https://api.chainstream.io/v2/token/{chain}/{tokenAddress}/similar \
  --header 'Authorization: Bearer <token>'
[
  {
    "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",
      "dexscreenerAd": true,
      "dexscreenerAdAt": 123,
      "dexscreenerBannerUrl": "<string>",
      "dexscreenerBoostAt": 123,
      "dexscreenerBoostFeeInUsd": "<string>",
      "dexscreenerTrendingBar": true,
      "dexscreenerTrendingBarAt": 123,
      "dexscreenerUpdateLink": true,
      "dexscreenerUpdateLinkAt": 123,
      "editionNonce": 1,
      "freezeAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
      "fungible": true,
      "isMutable": true,
      "isNative": false,
      "isVerifiedCollection": true,
      "isWrapped": false,
      "key": "Mint",
      "launchFromProgramAddress": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
      "launchFromProtocolFamily": "pumpfun",
      "launchQuoteTokenAddress": "<string>",
      "migratedAt": 1714857600000,
      "migratedToPoolAddress": "7AvUMqLBou5EAXzyhnizWmPU13u2VguJoBYdcX4bhJtQ",
      "migratedToProgramAddress": "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA",
      "migratedToProtocolFamily": "Raydium",
      "mintAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
      "primarySaleHappened": false,
      "programAddress": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "sellerFeeBasisPoints": 100,
      "tokenStandard": "Fungible",
      "updateAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV"
    },
    "extra": {
      "collectionAddress": "ABCDE",
      "dexscreenerAd": true,
      "dexscreenerAdAt": 123,
      "dexscreenerBannerUrl": "<string>",
      "dexscreenerBoostAt": 123,
      "dexscreenerBoostFeeInUsd": "<string>",
      "dexscreenerTrendingBar": true,
      "dexscreenerTrendingBarAt": 123,
      "dexscreenerUpdateLink": true,
      "dexscreenerUpdateLinkAt": 123,
      "editionNonce": 1,
      "freezeAuthority": "B61ZzjjZskE9yur2CBe4H4NFS3XHdEZdatKNegC9smUV",
      "fungible": true,
      "isMutable": true,
      "isNative": false,
      "isVerifiedCollection": true,
      "isWrapped": false,
      "key": "Mint",
      "launchFromProgramAddress": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
      "launchFromProtocolFamily": "pumpfun",
      "launchQuoteTokenAddress": "<string>",
      "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": {
      "athMarketCapInUsd": "9500000.00",
      "bluechipHoldingsRatio": "0.05",
      "bluechipTotalHolders": "10",
      "bluechipTotalHoldings": "50000",
      "bundleHoldingsRatio": "0.018",
      "bundleTotalHolders": "12",
      "bundleTotalHoldings": "18000",
      "circulatingSupply": "900000",
      "completionRatio": "1.0",
      "creatorsHoldingsRatio": "0.10",
      "creatorsTotalHolders": "1",
      "creatorsTotalHoldings": "100000000.00",
      "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",
      "maxSupply": "<string>",
      "phishingHoldingsRatio": "0.0005",
      "phishingTotalHolders": "2",
      "phishingTotalHoldings": "50000.00",
      "priceInNative": "0.00000261383847574915906643405542",
      "priceInSol": "0.00000261383847574915906643405542",
      "priceInUsd": "0.00000261383847574915906643405542",
      "proHoldingsRatio": "0.04",
      "proTotalHolders": "25",
      "proTotalHoldings": "40000",
      "ratHoldingsRatio": "0.0012",
      "ratTotalHolders": "5",
      "ratTotalHoldings": "120000.00",
      "sandwishHoldingsRatio": "0.015",
      "sandwishTotalHolders": "8",
      "sandwishTotalHoldings": "15000",
      "smartHoldingsRatio": "0.03",
      "smartTotalHolders": "30",
      "smartTotalHoldings": "3000000.00",
      "sniperHoldingsRatio": "0.025",
      "sniperTotalHolders": "15",
      "sniperTotalHoldings": "25000",
      "top100HoldingsRatio": "0.8",
      "top100TotalHolders": "100",
      "top100TotalHoldings": "800000",
      "top10HoldingsRatio": "0.5",
      "top10TotalHolders": "10",
      "top10TotalHoldings": "500000",
      "top50HoldingsRatio": "0.3",
      "top50TotalHolders": "50",
      "top50TotalHoldings": "300000",
      "totalSupply": "1000000",
      "totalTvlInSol": "1000000.45",
      "totalTvlInUsd": "1000000.45"
    },
    "metadataAddress": "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s",
    "score": 123,
    "scoreBreakdown": {
      "ageScore": 123,
      "finalScore": 123,
      "holderConcentrationPenalty": 123,
      "holdersScore": 123,
      "liquidityScore": 123,
      "marketCapScore": 123,
      "priceChangeScore": 123,
      "safetyPenalty": 123,
      "smartMoneyScore": 123,
      "symbolExactMatchBonus": 123,
      "tierBoost": 123,
      "txCountScore": 123,
      "volumeScore": 123
    },
    "security": {
      "buyTax": "<string>",
      "holderCount": "<string>",
      "isBlacklisted": true,
      "isFreezable": true,
      "isHoneypot": true,
      "isMintable": true,
      "isOpenSource": true,
      "isProxy": true,
      "isRenounced": true,
      "isShowAlert": true,
      "lpHolderCount": "<string>",
      "ownerAddress": "<string>",
      "sellTax": "<string>",
      "sourcesAvailable": [
        "goplus"
      ]
    },
    "socialMedias": {
      "bitbucket": "https://bitbucket.org/circle",
      "discord": "https://discord.gg/circle",
      "facebook": "https://facebook.com/circle",
      "farcaster": "https://warpcast.com/vitalik",
      "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": {
        "6h": {
          "buyVolumeInUsd": "12000.00",
          "buyers": "120",
          "buys": "420",
          "closeInUsd": "0.15600000",
          "currentLiquidityInUsd": "250000.00",
          "highInUsd": "0.15900000",
          "lowInUsd": "0.15100000",
          "openInUsd": "0.15200000",
          "priceChangeRatioInUsd": "0.02631579",
          "sellVolumeInUsd": "9800.00",
          "sellers": "95",
          "sells": "360",
          "totalVolumeInUsd": "21800.00",
          "traders": "215",
          "trades": "780"
        }
      }
    },
    "tier": 123,
    "tokenCreatedAt": 1710417600000,
    "tokenCreatedBlockHeight": "220000000",
    "tokenCreatedSlot": "230000000",
    "tokenCreatedTxSignature": "5dJ1BxPiFT7w7aBdkxNy2jopGZnZoLwRwS8e9GkEXrVz...",
    "tokenCreators": [
      {
        "address": "5e2qRc1DNEXmyxP8qwPwJhRWjef7usLyi7v5xjqLr5G7",
        "isVerified": true,
        "share": 100
      }
    ],
    "uri": "https://arweave.net/abc123",
    "warningBadge": "<string>"
  }
]

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

Available options:
sol,
eth,
bsc
​
tokenAddress
string
required

An address of a token

Query Parameters

​
type
enum<string>

Similarity type: Image or Name

Available options:
image,
name
​
limit
integer<int64>

Maximum number of results (1-100)

Response

200 - application/json

Get Similar

​
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
null | object

ENTITY.TOKEN.EXTENSION ENTITY.TOKEN.EXTENSION

​
extra
object

Extended token metadata

​
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

​
metadataAddress
string | null

On-chain metadata account address

Example:

"metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s"

​
score
number<double> | null

Search relevance score from OpenSearch _score

​
scoreBreakdown
null | object

Approximate factor-level score breakdown (debug / explainability)

​
security
object

Security audit summary

​
socialMedias
object

Token social media links

​
stats
object

Token statistics

​
tier
integer<int32> | null

Search tier: 0 = VIP, 1 = verified, 2 = emerging, null = unverified

​
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

​
uri
string | null

Token metadata URI

Example:

"https://arweave.net/abc123"

​
warningBadge
string | null

Warning badge: "unverified", "potential_scam", "honeypot", or null