GET
/api/v1/dex/dydx/markets/{ticker}Standard tier+ · 300 req/minSingle 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.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| ticker | string | required | — | 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.