---
title: "Get BBO"
method: GET
path: "/v1/info/bbo"
---

# Get BBO

`GET /v1/info/bbo`

Get best bid and offer for all instruments.

## Query parameters

- `instrument_id` integer — Instrument ID

## Response `200`

BBO response.

- BBO[]
  - `instrument_id` integer, required — Instrument ID
  - `bid_price` string, required — Best bid price
  - `bid_quantity` string, required — Best bid quantity
  - `ask_price` string, required — Best ask price
  - `ask_quantity` string, required — Best ask quantity
  - `timestamp` integer, required — Request timestamp. Unix milliseconds for most operations; Unix seconds for withdrawals (must match the on-chain EIP-712 struct verified against block.timestamp).

## Other responses

- `400` — Bad request — the request was malformed or failed validation (bad query parameters, unparseable body, invalid signature, or a domain pre-check). The `error` field is a human-readable validation detail.
- `429` — Too Many Requests. `error` distinguishes the limit that was hit: `ip_rate_limited` (per-IP token bucket), `action_rate_limited` (per-account action rate), or `open_orders_limit` (resting open-order cap).
- `500` — Internal server error. `error` is `internal_error`.

---

[API](https://skmtc.net/polymarket/apis/polymarket-perps-http-api.md) · [All operations](https://skmtc.net/polymarket/apis/polymarket-perps-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polymarket/polymarket-perps-http-api/revisions/76e4e47cf3aa/schema)