---
title: "Venue API Catalog (dYdX)"
type: summary
tags: [api, catalog, dydx, reference]
updated: 2026-06-19
confidence: high
sources: [raw/llms_txt-llms-txt-index.md, raw/llms_txt_doc-perpetualmarket.md, raw/llms_txt_doc-order.md, raw/llms_txt_doc-fundingpaymentresponseobject.md, raw/llms_txt_doc-perpetualpositionresponseobject.md, raw/llms_txt_doc-tradingperpetualmarket.md]
---

# Venue API Catalog (dYdX)

The dYdX docs (docs.dydx.xyz, ~70 pages mirrored in `raw/`) are this wiki's worked example of a perp venue's integration surface. This page maps that space so an agent fetches the exact reference page; the concept pages distill the trading mechanics.

## API surfaces

- **HTTP / REST API** (`http-rest-api`, `node-api`, `public-api`, `private-api`) — query markets, account state, fills, funding payments.
- **WebSocket API** (`websockets-api`) — streaming order book, fills, subaccount updates.
- **Indexer** (`indexer-deep-dive`) — the read layer behind the APIs.
- **Permissioned keys** (`permissioned-keys`, `permissioned-keys-api`) — scoped trading keys.

## Core data objects (one ref page each in raw/)

- Markets: `PerpetualMarket`, `TradingPerpetualMarket`, `ClobPairId`, `quantums-and-subticks`.
- Orders: `Order`, `OrderType`, `TimeInForce`, `OrderResponseObject`, `OrderSubaccountMessage`.
- Positions/accounts: `accounts-and-subaccounts`, `PerpetualPositionResponseObject`, `AssetPositionSubaccountMessage`, `SubaccountResponseObject`.
- Fills & funding: `FillResponseObject`, `FillType`, `FundingPaymentResponseObject`.
- Advanced: `BuilderCodeParameters`, `TwapParameters`, `megavault` (pooled liquidity vault).

## Trading mechanics pages (distilled into this wiki)

`funding` → [funding-rates](../concepts/funding-rates.md); `margining` → [margin-and-leverage](../concepts/margin-and-leverage.md); `liquidations` + `contract-loss-mechanisms` → [liquidations-and-deleveraging](../concepts/liquidations-and-deleveraging.md); `oracle-prices` → [mark-and-oracle-price](../concepts/mark-and-oracle-price.md); `isolated-markets` / `isolated-positions` → [cross-vs-isolated-margin](../concepts/cross-vs-isolated-margin.md).

For exact request/response shapes, read the specific object page in `raw/`. Other venues expose different APIs for the same concepts.