API Reference

Base URL: https://api.venum.dev

Endpoints

Free (no auth, cached)

Method	Path	Description	Cache
GET	/health	API health check	—
GET	/v1/price/:token	DEX price for a token	2s
GET	/v1/prices?tokens=	Batch DEX prices	2s
GET	/v1/pools	Browse pools (filter by token/pair/dex)	5s
GET	/v1/pools/:token	Pools for a token	5s
GET	/v1/pools/:tokenA/:tokenB	Pools for a pair	5s
GET	/v1/tokens	Supported token list with mints + categories	60s

Paid (requires X-API-Key header)

Method	Path	Description
POST	/v1/quote	Get best swap route across all major DEXes
POST	/v1/swap/build	Build unsigned swap transaction
POST	/v1/swap	Submit signed swap transaction via Jito (requires quoteId)
POST	/v1/send	Submit ANY signed transaction via Jito + RPC
GET	/v1/pool/:address	Single pool decoded state
GET	/v1/pools/new	Recently discovered pools
GET	/v1/pools/seed	Bulk pool export (paginated)
GET	/v1/pools/dead	Dead pool detection (coming soon)
GET	/v1/tx/:signature	Transaction status + confirmation details
GET	/v1/stream/prices	SSE: real-time price updates
GET	/v1/stream/pools	SSE: new pool discoveries

Authentication

Paid endpoints require an API key in the X-API-Key header:

X-API-Key: your_api_key_here

Free endpoints work without auth. Passing an API key on free endpoints bypasses the cache and gives you higher rate limits.

Plans & Rate Limits

Endpoint	Anonymous	Free	Starter $49/mo	Pro $199/mo
Prices	30/min, cached	60/min	300/min	1000/min
Pools browse	15/min, cached	30/min	150/min	500/min
Tokens	10/min, cached	30/min	100/min	300/min
Quote	—	10/min	60/min	300/min
Swap build	—	5/min	30/min	150/min
Swap / Send	—	2/min	15/min	60/min
TX status	—	5/min	30/min	150/min
Pool details	—	10/min	60/min	300/min
SSE streams	—	1 conn	3 conn	10 conn

No swap fees on any tier. Sign up for a free API key →

Token Resolution

All endpoints accept both token symbols and mint addresses:

GET /v1/price/SOL
GET /v1/price/So11111111111111111111111111111111111111112
GET /v1/pools/SOL/USDC
GET /v1/pools?pair=SOL,USDC

Aliases: BTC → WBTC, ETH → WETH, DOGE → wDOGE, SHIB → wSHIB, NEAR → wNEAR

Content Type

All request bodies are JSON:

Content-Type: application/json

Base Types

Token Mint

Base58-encoded Solana public key (32-44 characters):

So11111111111111111111111111111111111111112

Amount

String representation of a positive integer in the token's smallest unit:

"1000000000"  // 1 SOL (9 decimals)
"1000000"     // 1 USDC (6 decimals)

Slippage

Integer in basis points (1 bps = 0.01%):

100   // 1% slippage
50    // 0.5% slippage