Cryptocurrency — entry 032 of 53
dYdX
dYdX is a decentralized perpetuals exchange that migrated from its StarkEx-based v3 to a Cosmos-chain v4 architecture, replacing the old exchange API with an open-source Indexer exposing markets, orderbooks, trades, and candles over REST and WebSocket. Anyone can run their own Indexer instance, but the public one at indexer.dydx.trade needs no signup for market-data reads — it's rate-limited rather than API-key gated.
dYdX v4's Indexer is a keyless, read-only REST and WebSocket service that mirrors on-chain state for the dYdX Cosmos appchain — markets, orderbooks, trades, and candles all live here, built by parsing the chain rather than sitting in the trading path itself.
AuthenticationNone requiredCall it straight away — no key, no signup.
HTTPSSupportedTraffic is encrypted in transit.
CORSEnabledCallable directly from browser JavaScript.
PricingFreeNo paid tier — free for the documented use case.
FormatsJSON, WebSocketResponses can be requested as JSON or WebSocket.
GreatAPIs Score
Score100
Authentication25/25No authentication required
Pricing20/20Free to use
Docs20/20Machine-readable spec file bundled
Formats15/15Supports 2 response formats
Freshness20/20Verified within 6 months
Embed this badge
<a href="https://greatapis.com/api/dydx/"><img src="https://greatapis.com/badge/dydx.svg" alt="Scored 100 on greatapis.com"></a>Auth quickstart
- No API key required — the public Indexer at
indexer.dydx.tradeis a keyless, read-only, eventually-consistent view. Every response carries liveratelimit-limit/ratelimit-remaining/ratelimit-resetheaders (a live response showedratelimit-limit: 100per short rolling per-IP window) rather than a fixed number published in the docs, so track those headers instead of assuming a hardcoded ceiling.
Stored keyNo key stored
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
addresses5
GET/addresses/{address}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | AddressResponse |
GET/addresses/{address}/parentSubaccountNumber/{parentSubaccountNumber}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | path | yes | string |
parentSubaccountNumber | path | yes | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | ParentSubaccountResponse |
POST/addresses/{address}/registerToken
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | path | yes | string |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | No content | — |
GET/addresses/{address}/subaccountNumber/{subaccountNumber}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | path | yes | string |
subaccountNumber | path | yes | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | SubaccountResponseObject |
POST/addresses/{address}/testNotification
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
204 | No content | — |
affiliates5
GET/affiliates/address
Parameters
| Name | In | Required | Type |
|---|---|---|---|
referralCode | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | AffiliateAddressResponse |
GET/affiliates/metadata
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | AffiliateMetadataResponse |
POST/affiliates/referralCode
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | CreateReferralCodeResponse |
GET/affiliates/snapshot
Parameters
| Name | In | Required | Type |
|---|---|---|---|
addressFilter | query | no | array |
offset | query | no | number |
limit | query | no | number |
sortByAffiliateEarning | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | AffiliateSnapshotResponse |
GET/affiliates/total_volume
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | AffiliateTotalVolumeResponse |
assetPositions2
GET/assetPositions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | AssetPositionResponse |
GET/assetPositions/parentSubaccountNumber
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | AssetPositionResponse |
candles1
GET/candles/perpetualMarkets/{ticker}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
ticker | path | yes | string |
resolution | query | yes | — |
limit | query | no | number |
fromISO | query | no | string |
toISO | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | CandleResponse |
compliance1
GET/compliance/screen/{address}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | ComplianceV2Response |
fills2
GET/fills
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
market | query | no | string |
marketType | query | no | — |
includeTypes | query | no | array |
excludeTypes | query | no | array |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
page | query | no | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | FillResponse |
GET/fills/parentSubaccount
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
includeTypes | query | no | array |
excludeTypes | query | no | array |
limit | query | no | number |
page | query | no | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | FillResponse |
fundingPayments2
GET/fundingPayments
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
limit | query | no | number |
ticker | query | no | string |
afterOrAt | query | no | — |
page | query | no | number |
zeroPayments | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | FundingPaymentResponse |
GET/fundingPayments/parentSubaccount
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
limit | query | no | number |
afterOrAt | query | no | — |
page | query | no | number |
zeroPayments | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | FundingPaymentResponse |
height1
GET/height
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | HeightResponse |
historical-pnl2
GET/historical-pnl
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
createdOnOrAfterHeight | query | no | number |
createdOnOrAfter | query | no | — |
page | query | no | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | HistoricalPnlResponse |
GET/historical-pnl/parentSubaccountNumber
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
createdOnOrAfterHeight | query | no | number |
createdOnOrAfter | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | HistoricalPnlResponse |
historicalBlockTradingRewards1
GET/historicalBlockTradingRewards/{address}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | path | yes | string |
limit | query | no | number |
startingBeforeOrAt | query | no | — |
startingBeforeOrAtHeight | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | HistoricalBlockTradingRewardsResponse |
historicalFunding1
GET/historicalFunding/{ticker}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
ticker | path | yes | string |
limit | query | no | number |
effectiveBeforeOrAtHeight | query | no | number |
effectiveBeforeOrAt | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | HistoricalFundingResponse |
historicalTradingRewardAggregations1
GET/historicalTradingRewardAggregations/{address}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | path | yes | string |
period | query | yes | — |
limit | query | no | number |
startingBeforeOrAt | query | no | — |
startingBeforeOrAtHeight | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | HistoricalTradingRewardAggregationsResponse |
orderbooks1
GET/orderbooks/perpetualMarket/{ticker}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
ticker | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | OrderbookResponseObject |
orders3
GET/orders
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
limit | query | no | number |
ticker | query | no | string |
side | query | no | — |
type | query | no | — |
includeTypes | query | no | array |
excludeTypes | query | no | array |
status | query | no | array |
goodTilBlockBeforeOrAt | query | no | number |
goodTilBlockAfter | query | no | number |
goodTilBlockTimeBeforeOrAt | query | no | — |
goodTilBlockTimeAfter | query | no | — |
returnLatestOrders | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | — |
GET/orders/parentSubaccountNumber
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
limit | query | no | number |
ticker | query | no | string |
side | query | no | — |
type | query | no | — |
includeTypes | query | no | array |
excludeTypes | query | no | array |
status | query | no | array |
goodTilBlockBeforeOrAt | query | no | number |
goodTilBlockAfter | query | no | number |
goodTilBlockTimeBeforeOrAt | query | no | — |
goodTilBlockTimeAfter | query | no | — |
returnLatestOrders | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | — |
GET/orders/{orderId}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
orderId | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | OrderResponseObject |
perpetualMarkets1
GET/perpetualMarkets
Parameters
| Name | In | Required | Type |
|---|---|---|---|
limit | query | no | number |
ticker | query | no | string |
market | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | PerpetualMarketResponse |
perpetualPositions2
GET/perpetualPositions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
status | query | no | array |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | PerpetualPositionResponse |
GET/perpetualPositions/parentSubaccountNumber
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
status | query | no | array |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | PerpetualPositionResponse |
pnl2
GET/pnl
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
createdOnOrAfterHeight | query | no | number |
createdOnOrAfter | query | no | — |
page | query | no | number |
daily | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | PnlResponse |
GET/pnl/parentSubaccountNumber
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
createdOnOrAfterHeight | query | no | number |
createdOnOrAfter | query | no | — |
daily | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | PnlResponse |
screen1
GET/screen
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | ComplianceResponse |
sparklines1
GET/sparklines
Parameters
| Name | In | Required | Type |
|---|---|---|---|
timePeriod | query | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | SparklineResponseObject |
time1
GET/time
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | TimeResponse |
tradeHistory2
GET/tradeHistory
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
market | query | no | string |
marketType | query | no | — |
limit | query | no | number |
page | query | no | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | TradeHistoryResponse |
GET/tradeHistory/parentSubaccountNumber
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
market | query | no | string |
marketType | query | no | — |
limit | query | no | number |
page | query | no | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | TradeHistoryResponse |
trader1
GET/trader/search
Parameters
| Name | In | Required | Type |
|---|---|---|---|
searchParam | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | TraderSearchResponse |
trades1
GET/trades/perpetualMarket/{ticker}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
ticker | path | yes | string |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
page | query | no | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | TradeResponse |
transfers3
GET/transfers
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
subaccountNumber | query | yes | number |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
page | query | no | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | TransferResponse |
GET/transfers/between
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sourceAddress | query | yes | string |
sourceSubaccountNumber | query | yes | number |
recipientAddress | query | yes | string |
recipientSubaccountNumber | query | yes | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | TransferBetweenResponse |
GET/transfers/parentSubaccountNumber
Parameters
| Name | In | Required | Type |
|---|---|---|---|
address | query | yes | string |
parentSubaccountNumber | query | yes | number |
limit | query | no | number |
createdBeforeOrAtHeight | query | no | number |
createdBeforeOrAt | query | no | — |
page | query | no | number |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | ParentSubaccountTransferResponse |
turnkey3
POST/turnkey/appleLoginRedirect
Request body
application/json — AppleLoginRedirectRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | AppleLoginResponse |
POST/turnkey/signin
Request body
application/json — SignInRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | TurnkeyAuthResponse |
POST/turnkey/uploadAddress
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | — |
vault3
GET/vault/v1/megavault/historicalPnl
Parameters
| Name | In | Required | Type |
|---|---|---|---|
resolution | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | MegavaultHistoricalPnlResponse |
GET/vault/v1/megavault/positions
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | MegavaultPositionResponse |
GET/vault/v1/vaults/historicalPnl
Parameters
| Name | In | Required | Type |
|---|---|---|---|
resolution | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Ok | VaultsHistoricalPnlResponse |
Try it
Developer reference
Base URL
https://indexer.dydx.trade/v4Rate limit
100 requests per short rolling per-IP window, per the live `ratelimit-limit`/`ratelimit-remaining`/`ratelimit-reset` response headers on indexer.dydx.trade — docs.dydx.xyz does not publish a fixed public number itself.
Key endpoints
- GET/perpetualMarkets
- GET/time
- GET/height
Gotchas & limits
- The response nests a single market under
markets, keyed by ticker (e.g.markets["BTC-USD"]) — even a?ticker=-filtered request still returns an object, not a flat record or an array. - v3 (the original StarkEx-based exchange API) is gone — v4's open-source Indexer is the only public dYdX market-data API today; v3 endpoint paths and client code won't work against it.
- Almost every numeric-looking field (
oraclePrice,priceChange24H,volume24H, the margin fractions,openInterest) is a JSON string; only a handful liketrades24H,atomicResolution, andstepBaseQuantumscome through as real numbers. - A live response carried a
geo-origin-status: restrictedheader alongsidegeo-origin-country/geo-origin-region— the Indexer geo-tags requests and can restrict access by jurisdiction, so don't assume every caller gets identical responses regardless of origin.
Availability
Uptime100%
Median latency358 ms
Last checkUp · 200 · Sep 2026
Changelog
Spec versionv1.0.0
Tracked paths49
- gained an OpenAPI spec