For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.

Join Community Start Trading

Home Overview DIME Utility Trading Risk & Liquidations VTFs Paradex Chain Ecosystem REST API WebSocket API Agentic AI Hub Release Notes

Home Overview DIME Utility Trading Risk & Liquidations VTFs Paradex Chain Ecosystem REST API WebSocket API Agentic AI Hub Release Notes

General Information
Production API Reference
Testnet API Reference
Useful Resources

Join Community Start Trading

Production API Reference Markets

Get market bbo

GET

https://api.prod.paradex.trade/v1/bbo/:market

GET

/v1/bbo/:market

$ curl -X GET https://api.prod.paradex.trade/v1/bbo/{market} \
>  -H 'Accept: application/json'

1 {
2   "ask": "30130.15",
3   "ask_size": "0.05",
4   "bid": "30112.22",
5   "bid_size": "0.04",
6   "last_updated_at": 1681493939981,
7   "market": "BTC-USD-PERP",
8   "seq_no": 20784
9 }

Get the best bid/ask for the given market

Was this page helpful?

Get market bbo including all orders including RPI (as seen by the UI)

Path parameters

marketstringRequired

Market symbol - ex: BTC-USD-PERP

Response

OK

askstring

Best ask price

ask_sizestring

Best ask size

bidstring

Best bid price

bid_sizestring

Best bid size

last_updated_atinteger

Last update to the orderbook in milliseconds

marketstring

Symbol of the market

seq_nointeger

Sequence number of the orderbook

Errors

400

Bad Request Error