GET
/
v1
/
token
/
search
Token - Search
curl --request GET \
  --url https://api-dex.chainstream.io/v1/token/search \
  --header 'Authorization: Bearer <token>'
{
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "<string>",
  "endCursor": "<string>",
  "total": 123,
  "countsByProtocols": {
    "uniswap": 500,
    "sushiswap": 300
  },
  "data": [
    {
      "chain": "solana",
      "decimals": 9,
      "name": "USD Coin",
      "symbol": "USDC",
      "metadataAddress": "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s",
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "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": 1714857600,
        "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": "2024-03-14T12:00:00Z",
      "description": "USDC is a stablecoin pegged to the US dollar",
      "market": "USDC-SOL",
      "extension": {
        "website": "https://www.circle.com/usdc",
        "twitter": "@circle"
      },
      "stats": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "price1m": "1.234",
        "buys1m": 150,
        "sells1m": 120,
        "buyVolumes1m": "50000.45",
        "sellsVolumes1m": "45000.32",
        "volumes1m": "95000.77",
        "buyVolumesInUsd1m": "50000.45",
        "sellVolumesInUsd1m": "45000.32",
        "volumesInUsd1m": "95000.77",
        "buyers1m": 50,
        "sellers1m": 45,
        "openPriceInUsd1m": "1.255",
        "closePriceInUsd1m": "1.265",
        "priceChangeRatioInUsd1m": "0.01",
        "trades1m": 270,
        "traders1m": 270,
        "highInUsd1m": "1.275",
        "lowInUsd1m": "1.235",
        "price5m": "1.245",
        "buys5m": 150,
        "sells5m": 120,
        "buyVolumes5m": "50000.45",
        "sellsVolumes5m": "45000.32",
        "volumes5m": "95000.77",
        "buyVolumesInUsd5m": "50000.45",
        "sellVolumesInUsd5m": "45000.32",
        "volumesInUsd5m": "95000.77",
        "buyers5m": 50,
        "sellers5m": 45,
        "openPriceInUsd5m": "1.255",
        "closePriceInUsd5m": "1.265",
        "priceChangeRatioInUsd5m": "0.01",
        "trades5m": 270,
        "traders5m": 270,
        "highInUsd5m": "1.275",
        "lowInUsd5m": "1.235",
        "price15m": "1.255",
        "buys15m": 150,
        "sells15m": 120,
        "buyVolumes15m": "50000.45",
        "sellsVolumes15m": "45000.32",
        "volumes15m": "95000.77",
        "buyVolumesInUsd15m": "50000.45",
        "sellVolumesInUsd15m": "45000.32",
        "volumesInUsd15m": "95000.77",
        "buyers15m": 50,
        "sellers15m": 45,
        "openPriceInUsd15m": "1.255",
        "closePriceInUsd15m": "1.265",
        "priceChangeRatioInUsd15m": "0.01",
        "trades15m": 270,
        "traders15m": 270,
        "highInUsd15m": "1.275",
        "lowInUsd15m": "1.235",
        "price30m": "1.265",
        "buys30m": 150,
        "sells30m": 120,
        "buyVolumes30m": "50000.45",
        "sellsVolumes30m": "45000.32",
        "volumes30m": "95000.77",
        "buyVolumesInUsd30m": "50000.45",
        "sellVolumesInUsd30m": "45000.32",
        "volumesInUsd30m": "95000.77",
        "buyers30m": 50,
        "sellers30m": 45,
        "openPriceInUsd30m": "1.255",
        "closePriceInUsd30m": "1.265",
        "priceChangeRatioInUsd30m": "0.01",
        "trades30m": 270,
        "traders30m": 270,
        "highInUsd30m": "1.275",
        "lowInUsd30m": "1.235",
        "price1h": "1.275",
        "buys1h": 150,
        "sells1h": 120,
        "buyVolumes1h": "50000.45",
        "sellsVolumes1h": "45000.32",
        "volumes1h": "95000.77",
        "buyVolumesInUsd1h": "50000.45",
        "sellVolumesInUsd1h": "45000.32",
        "volumesInUsd1h": "95000.77",
        "buyers1h": 50,
        "sellers1h": 45,
        "openPriceInUsd1h": "1.255",
        "closePriceInUsd1h": "1.265",
        "priceChangeRatioInUsd1h": "0.01",
        "trades1h": 270,
        "traders1h": 270,
        "highInUsd1h": "1.275",
        "lowInUsd1h": "1.235",
        "price4h": "1.285",
        "buys4h": 150,
        "sells4h": 120,
        "buyVolumes4h": "50000.45",
        "sellsVolumes4h": "45000.32",
        "volumes4h": "95000.77",
        "buyVolumesInUsd4h": "50000.45",
        "sellVolumesInUsd4h": "45000.32",
        "volumesInUsd4h": "95000.77",
        "buyers4h": 50,
        "sellers4h": 45,
        "openPriceInUsd4h": "1.255",
        "closePriceInUsd4h": "1.265",
        "priceChangeRatioInUsd4h": "0.01",
        "trades4h": 270,
        "traders4h": 270,
        "highInUsd4h": "1.275",
        "lowInUsd4h": "1.235",
        "price24h": "1.295",
        "buys24h": 150,
        "sells24h": 120,
        "buyVolumes24h": "50000.45",
        "sellsVolumes24h": "45000.32",
        "volumes24h": "95000.77",
        "buyVolumesInUsd24h": "50000.45",
        "sellVolumesInUsd24h": "45000.32",
        "volumesInUsd24h": "95000.77",
        "buyers24h": 50,
        "sellers24h": 45,
        "openPriceInUsd24h": "1.255",
        "closePriceInUsd24h": "1.265",
        "priceChangeRatioInUsd24h": "0.01",
        "trades24h": 270,
        "traders24h": 270,
        "highInUsd24h": "1.275",
        "lowInUsd24h": "1.235"
      },
      "liquidity": [
        {
          "programAddress": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
          "protocolFamily": "OrcaWhirpool",
          "image": "https://ipfs.io/ipfs/bafkreid7667676767676767676767676767676767676767676767676767676767676767",
          "chain": "sol",
          "poolAddress": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
          "protocolName": "OrcaWhirpool AMM V2",
          "tokenAAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "tokenBAddress": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
          "tvlInUsd": "1000000.45",
          "tvlInSol": "1000000.45"
        }
      ],
      "marketData": {
        "totalSupply": "1000000",
        "marketCapInSol": "100000",
        "marketCapInUsd": "100000",
        "top10TotalHoldings": "100000",
        "top10HoldingsRatio": "0.1",
        "top100TotalHoldings": "500000",
        "top100HoldingsRatio": "0.5",
        "holders": 1000,
        "priceInSol": "0.00000261383847574915906643405542",
        "priceInUsd": "0.00000261383847574915906643405542",
        "tvlInSol": "0.00000261383847574915906643405542",
        "tvlInUsd": "0.00000261383847574915906643405542",
        "completionRatio": "0.1",
        "devTeamCount": 1,
        "devTeamAmount": "10000",
        "devTeamRatio": "0.5"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
chains
string[]

Chain filter

​
q
string

Search query string for token name, symbol or address

Minimum length: 1
Example:

"USDC"

​
limit
number
default:20

Number of results per page

Required range: 1 <= x <= 100
​
sort
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
protocols
string[]

Protocol filter, for supported protocols please check the dexName values returned by DEX - List

​
cursor
string

Pagination cursor

​
sortBy
enum<string>

Field to sort by

Available options:
marketCapInUsd,
liquidityInUsd,
priceInUsd,
holderCount,
h24VolumeInUsd,
h24Transactions,
tokenCreatedAt
Example:

"priceInUsd"

Response

200 - application/json
​
data
object[]
required

Array of token data

​
hasNext
boolean
default:false

Indicates if there are more results

​
hasPrev
boolean
default:false

Indicates if there are previous results

​
startCursor
string

Cursor for first item in current page

​
endCursor
string

Cursor for last item in current page

​
total
number

Total number of items

​
countsByProtocols
object

Token count by protocol

Example:
{ "uniswap": 500, "sushiswap": 300 }