Skip to main content
Loading market data…
GET/api/v1/dex/dydx/markets/{ticker}Standard tier+ · 300 req/min

Single dYdX v4 market by canonical symbol or base asset.

Pass either the full canonical symbol (`BTC-USD-PERP`) or the bare base (`BTC`) — the first match wins, canonical-first.

Path parameters

Segments of the URL path, validated server-side.

NameTypeRequiredDefaultDescription
tickerstringrequired
Canonical symbol or base asset. Case-insensitive.

Query parameters

This endpoint takes no query parameters.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

data payloadtypescript
// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{ source; displayName; market: DexMarketRow }

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

Requestbash
curl -sS "http://localhost:3000/api/v1/dex/dydx/markets/BTC"
Responsejson
{ "data": { "source": "dydx_v4", "displayName": "dYdX v4", "market": {} }, "meta": { "total": 1 } }

Notes

  • 404 when no matching market exists.

Next

Check the error code reference, or get an API key to try the request against your own account.