GET
/
token
/
search
curl --request GET \
  --url https://api-dex.chainstream.io/token/search \
  --header 'Authorization: Bearer <token>'
{
  "total": 1000,
  "countsByProtocols": {
    "uniswap": 500,
    "sushiswap": 300
  },
  "data": [
    {
      "chain": "solana",
      "decimals": "9",
      "name": "USD Coin",
      "symbol": "USDC",
      "metadataAddress": "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s",
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "tokenCreators": "[\"FEwwZPKvLFUy3o1qK1b167qDLLNvk7wd7YeupR7LhRWw\"]",
      "imageUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
      "uri": "https://...",
      "extra": "{}",
      "metadata": "{}",
      "socialMedias": "{\"twitter\":\"@circle\",\"website\":\"https://www.circle.com\"}",
      "tokenCreatedAt": "2024-03-14T12:00:00Z",
      "description": "USDC is a stablecoin pegged to the US dollar",
      "market": "USDC-SOL",
      "deployer": "FEwwZPKvLFUy3o1qK1b167qDLLNvk7wd7YeupR7LhRWw",
      "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",
        "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",
        "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",
        "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",
        "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",
        "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",
        "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"
      },
      "liquidity": [
        {
          "programAddress": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
          "dexName": "OrcaWhirpool",
          "chain": "sol",
          "poolAddress": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
          "baseTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "quoteTokenAddress": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
          "tvlInUsd": "1000000.45",
          "tvlInSol": "1000000.45"
        }
      ],
      "marketData": {
        "circulatingSupply": "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"
      }
    }
  ],
  "next": "eyJpZCI6MTAwfQ==",
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "eyJpZCI6MTAwfQ==",
  "endCursor": "eyJpZCI6MjAwfQ=="
}

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

List of tokens

total
number

Total number of tokens

Example:

1000

countsByProtocols
object

Token count by protocol

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

Cursor for the next page

Example:

"eyJpZCI6MTAwfQ=="

hasNext
boolean
default:false

Indicates if there are more results

hasPrev
boolean
default:false

Indicates if there are previous results

startCursor
object

Cursor for first item in current page

Example:

"eyJpZCI6MTAwfQ=="

endCursor
object

Cursor for last item in current page

Example:

"eyJpZCI6MjAwfQ=="