// Developers
> Build on Duckpot.
REST + WebSocket API. Stable, versioned, and free for public market data.
AI / MCP connection
Connect Duckpot to ChatGPT, Claude, Cursor or VS Code with OAuth 2.1 and the Model Context Protocol.
MCP server URL
https://duckpot.xyz/mcp1
Copy the URL below
https://duckpot.xyz/mcp
2
Setup must be completed on ChatGPT / Claude or any AI web client
Go to Settings → Security and login → Developer mode and turn it on. Developer mode is not available in the mobile app — open ChatGPT or Claude on web.
3
Add a new connector
Open Plugins / Connectors, select Browse, hit +, then choose New Plugin. Name it Duckpot, choose Server URL and paste the URL above.
4
Authentication: OAuth (required)
Do not leave “No Auth” selected. Save the connector, connect it, and complete the OAuth authorization with your Duckpot account.
REST endpoints
GET
/api/public/v1/summary
CMC Summary — overview of all spot market pairs (last price, 24h high/low/volume, % change).
GET
/api/public/v1/assets
CMC Assets — per-currency details: name, unified_cryptoasset_id, can_withdraw/deposit, fees.
GET
/api/public/v1/ticker
CMC Ticker — 24h pricing and volume per market pair, keyed by BASE-QUOTE (e.g. BTC-USDT).
GET
/api/public/v1/orderbook/{market_pair}
CMC Orderbook — full L2 depth. Path uses dash, e.g. BTC-USDT. Query: ?depth=100 (50/side).
GET
/api/public/v1/trades/{market_pair}
CMC Trades — last 24h of completed trades for a market pair, e.g. BTC-USDT.
GET
/api/public/v1/contracts
CMC Derivatives B1+B2 — list of all perpetual contracts with pricing, OI, funding rate, contract specs.
GET
/api/public/v1/contract-orderbook/{ticker_id}
CMC Derivatives B3 — perpetual contract order book. Ticker format: BTC-PERPUSDT.
WebSocket channels
Base URL: wss://stream.duckpot.exchange/ws
ticker
Real-time price + 24h stats per symbol.
depth
Incremental orderbook updates.
kline.1m
Streaming 1-minute candles.
trades
Public trade tape.
Rate limits
- Public REST: 1,200 requests/min per IP.
- Authenticated REST: 6,000 requests/min per API key.
- WebSocket: 240 messages/sec per connection; max 50 subscriptions.
Authentication
HMAC-SHA256 signed requests using your API key and secret. SDKs available for TypeScript, Python and Go: github.com/duckpot.
