API Documentation
Dex Api
- WebSocket
- Transaction
- Dex
- Defi
- Trade
- Order
- Token
- DexPool
- Ranking
- Wallet
Dex SDK
- JavaScript
Token - Search
Search token information by criteria
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
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Chain filter
Search query string for token name, symbol or address
1
"USDC"
Number of results per page
1 <= x <= 100
Sort direction
asc
, desc
Protocol filter, for supported protocols please check the dexName values returned by DEX - List
Pagination cursor
Field to sort by
marketCapInUsd
, liquidityInUsd
, priceInUsd
, holderCount
, h24VolumeInUsd
, h24Transactions
, tokenCreatedAt
"priceInUsd"
Response
List of tokens
Blockchain network identifier
"solana"
Token decimals
"9"
Token name
"USD Coin"
Token symbol
"USDC"
Metadata program address
"metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s"
Token mint address
"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
Token creator addresses
"[\"FEwwZPKvLFUy3o1qK1b167qDLLNvk7wd7YeupR7LhRWw\"]"
Token creation timestamp
"2024-03-14T12:00:00Z"
Token description
"USDC is a stablecoin pegged to the US dollar"
Market identifier
"USDC-SOL"
Token deployer address
"FEwwZPKvLFUy3o1qK1b167qDLLNvk7wd7YeupR7LhRWw"
Token stats
Token contract address
"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
Token price in the last 1 minute
"1.234"
Number of buy orders in the last 1 minute
"150"
Number of sell orders in the last 1 minute
"120"
Total buy volume in the last 1 minute
"50000.45"
Total sell volume in the last 1 minute
"45000.32"
Total trading volume in the last 1 minutes
"95000.77"
1m buy volume in USD
"50000.45"
1m sell volume in USD
"45000.32"
1m volume in USD
"95000.77"
Number of unique buyers in the last 1 minute
"50"
Number of unique sellers in the last 1 minute
"45"
Opening price in USD for the last 1 minute
"1.255"
Closing price in USD for the last 1 minute
"1.265"
Price change ratio in USD for the last 1 minute
"0.01"
Number of trades in the last 1 minute
"270"
Number of unique traders in the last 1 minute
"270"
Token price in the last 5 minutes
"1.245"
Number of buy orders in the last 5 minutes
"150"
Number of sell orders in the last 5 minutes
"120"
Total buy volume in the last 5 minutes
"50000.45"
Total sell volume in the last 5 minutes
"45000.32"
Total trading volume in the last 5 minutes
"95000.77"
5m buy volume in USD
"50000.45"
5m sell volume in USD
"45000.32"
5m volume in USD
"95000.77"
Number of unique buyers in the last 5 minutes
"50"
Number of unique sellers in the last 5 minutes
"45"
Opening price in USD for the last 5 minutes
"1.255"
Closing price in USD for the last 5 minutes
"1.265"
Price change ratio in USD for the last 5 minutes
"0.01"
Number of trades in the last 5 minutes
"270"
Number of unique traders in the last 5 minutes
"270"
Token price in the last 15 minutes
"1.255"
Number of buy orders in the last 15 minutes
"150"
Number of sell orders in the last 15 minutes
"120"
Total buy volume in the last 15 minutes
"50000.45"
Total sell volume in the last 15 minutes
"45000.32"
Total trading volume in the last 15 minutes
"95000.77"
15m buy volume in USD
"50000.45"
15m sell volume in USD
"45000.32"
15m volume in USD
"95000.77"
Number of unique buyers in the last 15 minutes
"50"
Number of unique sellers in the last 15 minutes
"45"
Opening price in USD for the last 15 minutes
"1.255"
Closing price in USD for the last 15 minutes
"1.265"
Price change ratio in USD for the last 15 minutes
"0.01"
Number of trades in the last 15 minutes
"270"
Number of unique traders in the last 15 minutes
"270"
Token price in the last 30 minutes
"1.265"
Number of buy orders in the last 30 minutes
"150"
Number of sell orders in the last 30 minutes
"120"
Total buy volume in the last 30 minutes
"50000.45"
Total sell volume in the last 30 minutes
"45000.32"
Total trading volume in the last 30 minutes
"95000.77"
30m buy volume in USD
"50000.45"
30m sell volume in USD
"45000.32"
30m volume in USD
"95000.77"
Number of unique buyers in the last 30 minutes
"50"
Number of unique sellers in the last 30 minutes
"45"
Opening price in USD for the last 30 minutes
"1.255"
Closing price in USD for the last 30 minutes
"1.265"
Price change ratio in USD for the last 30 minutes
"0.01"
Number of trades in the last 30 minutes
"270"
Number of unique traders in the last 30 minutes
"270"
Token price in the last 1 hour
"1.275"
Number of buy orders in the last 1 hour
"150"
Number of sell orders in the last 1 hour
"120"
Total buy volume in the last 1 hour
"50000.45"
Total sell volume in the last 1 hour
"45000.32"
Total trading volume in the last 1 hour
"95000.77"
1h buy volume in USD
"50000.45"
1h sell volume in USD
"45000.32"
1h volume in USD
"95000.77"
Number of unique buyers in the last 1 hour
"50"
Number of unique sellers in the last 1 hour
"45"
Opening price in USD for the last 1 hour
"1.255"
Closing price in USD for the last 1 hour
"1.265"
Price change ratio in USD for the last 1 hour
"0.01"
Number of trades in the last 1 hour
"270"
Number of unique traders in the last 1 hour
"270"
Token price in the last 4 hours
"1.285"
Number of buy orders in the last 4 hours
"150"
Number of sell orders in the last 4 hours
"120"
Total buy volume in the last 4 hours
"50000.45"
Total sell volume in the last 4 hours
"45000.32"
Total trading volume in the last 4 hour
"95000.77"
4h buy volume in USD
"50000.45"
4h sell volume in USD
"45000.32"
4h volume in USD
"95000.77"
Number of unique buyers in the last 4 hours
"50"
Number of unique sellers in the last 4 hours
"45"
Opening price in USD for the last 4 hours
"1.255"
Closing price in USD for the last 4 hours
"1.265"
Price change ratio in USD for the last 4 hours
"0.01"
Number of trades in the last 4 hours
"270"
Number of unique traders in the last 4 hours
"270"
Token price in the last 24 hours
"1.295"
Number of buy orders in the last 24 hours
"150"
Number of sell orders in the last 24 hours
"120"
Total buy volume in the last 24 hours
"50000.45"
Total sell volume in the last 24 hours
"45000.32"
Total trading volume in the last 24 hour
"95000.77"
24h buy volume in USD
"50000.45"
24h sell volume in USD
"45000.32"
24h volume in USD
"95000.77"
Number of unique buyers in the last 24 hours
"50"
Number of unique sellers in the last 24 hours
"45"
Opening price in USD for the last 24 hours
"1.255"
Closing price in USD for the last 24 hours
"1.265"
Price change ratio in USD for the last 24 hours
"0.01"
Number of trades in the last 24 hours
"270"
Number of unique traders in the last 24 hours
"270"
Market cap
Circulating supply
"1000000"
MarketCap in SOL
"100000"
MarketCap in USD
"100000"
Total holdings of top 10 holders
"100000"
Ratio of holdings by top 10 holders
"0.1"
Total holdings of top 100 holders
"500000"
Ratio of holdings by top 100 holders
"0.5"
Total number of token holders
"1000"
Price in SOL
"0.00000261383847574915906643405542"
Price in USD
"0.00000261383847574915906643405542"
TVL in SOL
"0.00000261383847574915906643405542"
TVL in USD
"0.00000261383847574915906643405542"
Token image URL
"https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png"
Metadata URI
"https://..."
Additional metadata
"{}"
Full metadata JSON
"{}"
Social media links
"{\"twitter\":\"@circle\",\"website\":\"https://www.circle.com\"}"
Additional token metadata
{
"website": "https://www.circle.com/usdc",
"twitter": "@circle"
}
Liquidity
DEX program address
"whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc"
Dex name
"OrcaWhirpool"
Blockchain
"sol"
Pool address
"58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"
Base token address
"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
Quote token address
"Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB"
Total value locked in USD
"1000000.45"
TVL in SOL
"1000000.45"
Total number of tokens
1000
Token count by protocol
{ "uniswap": 500, "sushiswap": 300 }
Cursor for the next page
"eyJpZCI6MTAwfQ=="
Indicates if there are more results
Indicates if there are previous results
Cursor for first item in current page
"eyJpZCI6MTAwfQ=="
Cursor for last item in current page
"eyJpZCI6MjAwfQ=="
Was this page helpful?
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=="
}