🔥 Trending GET
/trending
Top boosted tokens from DexScreener.
Parameters
| Name | Type | Required | Description | Example | Validation |
| limit | integer | false | Number of trending tokens to return | 20 | 1–100 |
Response Example
{
"success": true,
"data": [
{
"address": "So11111111111111111111111111111111111111112",
"chain": "solana",
"name": "Wrapped SOL",
"symbol": "SOL",
"price": 145.32,
"priceChange24h": 5.67,
"volume24h": 12345678,
"volumeFormatted": { "value": "12.35", "unit": "M", "numeric": 12345678 },
"boostAmount": 42,
"url": "https://dexscreener.com/solana/...",
"source": "dexScreener"
}
],
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Invalid limit parameter |
| 500 | INTERNAL_ERROR | Upstream API error |
📈 Volume Spikes GET
/volume-spikes
Tokens with highest 24h volume.
Parameters
| Name | Type | Required | Description | Example | Validation |
| limit | integer | false | Max items | 20 | ≥1 |
| min_volume | number | false | Minimum 24h volume in USD | 500000 | ≥0 |
Response Example
{
"success": true,
"data": [
{
"address": "0x...",
"chain": "ethereum",
"name": "Pepe",
"symbol": "PEPE",
"price": 0.00001234,
"priceChange24h": -2.1,
"volume24h": 9876543,
"volumeFormatted": { "value": "9.88", "unit": "M", "numeric": 9876543 },
"source": "dexScreener"
}
],
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Invalid limit or min_volume |
| 500 | INTERNAL_ERROR | Upstream API error |
🆕 New Tokens GET
/new-tokens
Recently created tokens (DexScreener profiles).
Parameters
None
Response Example
{
"success": true,
"data": [
{
"address": "0x...",
"chain": "ethereum",
"name": "New Meme",
"symbol": "NEW",
"icon": "https://...",
"description": "A brand new meme coin",
"createdAt": "2026-03-06T12:34:56Z",
"url": "https://dexscreener.com/ethereum/..."
}
],
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 500 | INTERNAL_ERROR | Failed to fetch profiles |
🔍 Token Details GET
/token/{address}
Complete market data by contract address.
Parameters
| Name | Type | Required | Description | Example | Validation |
| address | string | true | Token contract address | So11111111111111111111111111111111111111112 | valid base58/hex |
Response Example
{
"success": true,
"data": {
"address": "So11111111111111111111111111111111111111112",
"name": "Wrapped SOL",
"symbol": "SOL",
"chain": "solana",
"dexId": "raydium",
"priceUsd": 145.32,
"priceNative": 1.0,
"priceChange24h": 5.67,
"volume24h": 12345678,
"liquidity": 9876543,
"fdv": 5000000000,
"marketCap": 4800000000,
"pairAddress": "0x...",
"url": "https://dexscreener.com/solana/...",
"createdAt": 1698765432,
"boostsActive": true
},
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Missing token address |
| 404 | NOT_FOUND | Token not found |
| 500 | INTERNAL_ERROR | Upstream API error |
💧 Gecko Pools GET
/pools/{address}
Liquidity pools from GeckoTerminal.
Parameters
| Name | Type | Required | Description | Example | Validation |
| address | string | true | Token contract address | So11111111111111111111111111111111111111112 | - |
| network | string | false | Blockchain network | solana | solana, ethereum, bsc |
Response Example
{
"success": true,
"data": [
{
"dex": "Raydium",
"address": "0x...",
"name": "SOL/USDC",
"liquidity": 1500000,
"volume24h": 750000,
"priceUsd": 145.32,
"transactions": { "h24": { "buys": 123, "sells": 45 } },
"createdAt": "2023-01-01T00:00:00Z",
"url": "https://www.geckoterminal.com/solana/pools/..."
}
],
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Missing address or invalid network |
| 500 | INTERNAL_ERROR | GeckoTerminal API error |
💰 Yield Rankings GET
/yields
Top yield farming opportunities (DefiLlama).
Parameters
| Name | Type | Required | Description | Example | Validation |
| min_tvl | number | false | Minimum TVL in USD | 1000000 | ≥0 |
| limit | integer | false | Max items | 50 | ≥1 |
Response Example
{
"success": true,
"data": [
{
"chain": "Ethereum",
"project": "Lido",
"symbol": "stETH",
"tvlUsd": 20000000000,
"apy": 3.5,
"apyBase": 3.5,
"apyReward": 0,
"stablecoin": false,
"ilRisk": "no",
"poolMeta": "Curve",
"url": "https://defillama.com/yields/pool/..."
}
],
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Invalid parameters |
| 500 | INTERNAL_ERROR | DefiLlama API error |
🏆 DexPaprika Pools GET
/dexpaprika/top-pools
Top pools by volume.
Parameters
| Name | Type | Required | Description | Example | Validation |
| network | string | false | Blockchain network | ethereum | ethereum, bsc, polygon |
| limit | integer | false | Max items | 20 | ≥1 |
Response Example
{
"success": true,
"data": [ { "pool_id": "...", "volume_24h": 1000000 } ],
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Invalid network |
| 500 | INTERNAL_ERROR | DexPaprika API error |
⚡ Real-time Stream GET
/stream
SSE streaming for live prices (proxies DexPaprika).
Parameters
| Name | Type | Required | Description | Example | Validation |
| chain | string | false | Blockchain | ethereum | - |
| address | string | true | Token address | 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 | - |
Event Format
The stream passes through DexPaprika’s SSE format. Typical event:
data: {"price":1234.56,"timestamp":"2026-03-07T10:00:00Z"}
See DexPaprika docs for details.
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Missing address |
| 502 | STREAM_UNAVAILABLE | Streaming service unavailable |
🔎 Search GET
/search
Search for pairs by query (DexScreener).
Parameters
| Name | Type | Required | Description | Example | Validation |
| q | string | true | Search query | pepe | - |
Response Example
{
"success": true,
"data": [ { "pair": { ... } } ],
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Missing search query |
| 500 | INTERNAL_ERROR | DexScreener API error |
🔀 Multi‑Source GET
/multi-source/{address}
Aggregate token data from DexScreener + GeckoTerminal.
Parameters
| Name | Type | Required | Description | Example | Validation |
| address | string | true | Token contract address | So11111111111111111111111111111111111111112 | - |
Response Example
{
"success": true,
"data": {
"token": { ... },
"geckoPools": [ ... ]
},
"timestamp": "2026-03-07T10:00:00.000Z",
"version": "2.0"
}
Error Codes
| Status | Code | Description |
| 400 | BAD_REQUEST | Missing address |
| 500 | INTERNAL_ERROR | Aggregation error |
{
"success": true, // boolean, false if error
"data": { ... }, // payload (object or array)
"timestamp": "ISO string", // server time
"version": "2.0" // API version
}
On error:
{
"error": true,
"message": "Error description",
"timestamp": "...",
"version": "2.0"
}