Documentation Index

Fetch the complete documentation index at: https://docs.dexpaprika.com/llms.txt

Use this file to discover all available pages before exploring further.

​

DexPaprika API — Verified Reference (2026-03-02)

​

Base URLs

​

Pagination (applies to ALL list endpoints)

• Pages are 1-indexed. page=0 is silently treated as page=1.
• Max limit is 100. Values >100 return HTTP 400 (rejected, not capped).
• Exception: /pools/filter uses wrapper key results instead of pools.

"page_info": {
  "limit": 10,
  "page": 1,
  "total_items": 7838,
  "total_pages": 784
}

​

Endpoints

​

GET /networks

[
  {"id": "ethereum", "display_name": "Ethereum"},
  {"id": "solana", "display_name": "Solana"}
]

• 33 networks as of 2026-03-02
• Each item: 2 keys — id (string), display_name (string)
• Common IDs: ethereum, solana, bsc, arbitrum, base, polygon, optimism, avalanche

​

GET /stats

{
  "chains": 33,
  "factories": 205,
  "pools": 28185674,
  "tokens": 25916463
}

• 4 keys: chains, factories, pools, tokens
• Key is factories, NOT dexes — this is the DEX/factory count

​

GET /search?query=

{
  "tokens": [...],
  "pools": [...],
  "dexes": [...]
}

• Case-insensitive
• Empty query → 400
• Token result shape (15 keys):

• Pool result shape includes: id, dex_id, dex_name, chain, created_at_block_number, created_at, volume_usd, transactions, price_usd, last_price_change_usd_5m (nullable), last_price_change_usd_1h (nullable), last_price_change_usd_24h (nullable), tokens (array)

​

GET /networks//tokens/

​

GET /networks//multi/prices?tokens=,

[
  {"chain": "ethereum", "id": "0xc02a...", "price_usd": 1975.75},
  {"chain": "ethereum", "id": "0xa0b8...", "price_usd": 1.0001}
]

• Each item: 3 keys — chain, id, price_usd
• Order is NOT guaranteed
• Max 10 tokens. 11+ returns 400 with {"message":"max 10 tokens allowed."}
• Invalid/unknown tokens are silently omitted (not an error)
• All-invalid tokens → HTTP 200 with empty array []
• Comma-separated addresses in a single tokens param

​

GET /networks//pools

​

GET /networks//pools/filter

​

GET /networks//pools/

​

GET /networks//pools//ohlcv

​

GET /networks//pools//transactions

​

GET /networks//tokens//pools

​

GET /networks//dexes

​

GET /networks//dexes//pools

​

Streaming API

​

GET /sse/prices (single token)

GET https://streaming.dexpaprika.com/sse/prices?method=token_price&chain={network}&address={token_address}

​

POST /sse/prices (multiple tokens, up to 25)

POST https://streaming.dexpaprika.com/sse/prices
Content-Type: application/json
Accept: text/event-stream

[
  {"chain": "ethereum", "address": "0xc02a...", "method": "token_price"},
  {"chain": "solana",   "address": "So111...", "method": "token_price"}
]

​

GET /sse/reserves (single pool or token)

GET https://streaming.dexpaprika.com/sse/reserves?method=pool_reserves&chain={network}&address={pool_address}
GET https://streaming.dexpaprika.com/sse/reserves?method=token_reserves&chain={network}&address={token_address}

​

POST /sse/reserves (multiple, up to 25)

POST https://streaming.dexpaprika.com/sse/reserves
Content-Type: application/json
Accept: text/event-stream

[
  {"chain": "ethereum", "address": "0x88e6...", "method": "pool_reserves"},
  {"chain": "ethereum", "address": "0xa0b8...", "method": "token_reserves"}
]

​

SSE event format

event: token_price
data: {"address":"0xc02a...","chain":"ethereum","price":"2255.59","timestamp":1778847592,"timestamp_price":1778847592,"token_price":1778847592}

​

Streaming constraints

• Max 25 subscriptions per POST connection. 26+ entries get rejected with HTTP 400. The two endpoints use different rejection wording:
  • POST /sse/prices → {"message":"too many assets, max 25 allowed"}
  • POST /sse/reserves → {"message":"too many subscriptions"}
• Max 10 concurrent SSE streams per IP. 11th returns 429 {"message":"ip stream limit exceeded"}.
• Ping interval: 15 seconds (event: ping). Use a missing ping as a connection-liveness signal.
• All assets must be valid — one invalid asset cancels the entire stream with HTTP 400.
• First reserve events on a quiet pool may take seconds-to-minutes (events arrive only on actual on-chain changes).
• Treat unknown event names as no-ops.

​

Streaming errors

​

Error handling (REST)

​

Constraints summary

​

Common token addresses

​

Key gotchas for implementers

1. sells/buys not sell/buy — plural forms only in token summary time windows
2. summary.main_pool does not exist — to find a token’s best pool, query /tokens/{address}/pools?order_by=volume_usd&sort=desc&limit=1
3. Filter uses different field names than pool listing: address not id, volume_usd_24h not volume_usd, txns_24h not transactions
4. Filter wrapper key is results, not pools
5. Stats key is factories, not dexes
6. Pages are 1-indexed everywhere — page=0 is silently normalized to page=1
7. Limits are enforced, not capped — limit=200 returns 400, not 100 results
8. Streaming p is a string — parse as decimal for precision, do not treat as JSON number
9. Streaming bare URL is 404 — only /stream path works
10. Search token shape ≠ token details shape — different fields at top level
11. OHLCV is the only flat-array list response — all other list endpoints wrap in {key: [...], page_info: {...}}
12. DEXes endpoint page_info is buggy — may show total_items: 0 while returning all results
13. Non-functional filter params (volume_7d_min, volume_30d_min, liquidity_usd_min, liquidity_usd_max) are accepted but always return 0 results
14. First streaming events may take 10-20 seconds — don’t use short timeouts