dYdX Indexer API

Name: dYdX Indexer API API
Brand: dYdX Indexer API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentFinanceBankingnone49 EndpointsREST

For Agents

Query dYdX v4 perpetual market data, account positions, orders, fills, funding payments, and trading rewards over a public REST surface so agents can monitor or analyse on-chain trading without a node.

Quickstart

Get started with dYdX Indexer API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"get the order book for a dYdX perpetual market"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with dYdX Indexer API API.

Fetch live order books and candles for any perpetual market by ticker

List perpetual markets and their current configuration and status

Retrieve subaccount and parent subaccount balances and asset positions for an address

List orders and fills filtered by address, subaccount, market, or status

GET STARTED

Start building with dYdX Indexer API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for dYdX Indexer API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for the dYdX Indexer API, keeping it validated and agent-ready. The dYdX Indexer is the read-only REST surface for the dYdX v4 decentralized perpetual exchange, exposing market data, order books, candles, account positions, fills, funding payments, historical PnL, and trading rewards across subaccounts and parent subaccounts. The API is unauthenticated for read access - it serves indexed chain data so trading bots, dashboards, and agents can query state on the dYdX chain without running a node.

Use Cases

Patterns agents use dYdX Indexer API API for, with concrete tasks.

★ Trading Bot Market Data Feed

An algorithmic trading bot pulls candles and order book snapshots from the Indexer to drive a signal model, then queries its own subaccount fills and positions to reconcile orders placed via the on-chain validator. Because the Indexer aggregates chain state, the bot avoids running a full dYdX node and can scale read traffic independently of execution.

GET /candles/perpetualMarkets/ETH-USD with 1HOUR resolution and GET /orderbooks/perpetualMarket/ETH-USD, then merge into the bot's local market state

Portfolio Dashboard for dYdX Traders

A portfolio tool reads positions, asset balances, fills, and historical PnL for a wallet's subaccounts and renders an aggregated view across markets. The /historical-pnl/parentSubaccountNumber and /assetPositions/parentSubaccountNumber endpoints roll subaccounts up by parent so multi-account traders see one total without per-subaccount stitching.

GET /addresses/{address}/parentSubaccountNumber/0 followed by /historical-pnl/parentSubaccountNumber and /assetPositions/parentSubaccountNumber to assemble a parent-level PnL view

Trading Rewards and Funding Reconciliation

An accounting workflow pulls funding payments and historical block trading reward aggregations for an address to reconcile expected vs received rewards across epochs. The Indexer exposes these as paginated endpoints keyed by address, so a job can backfill all epochs without reading the chain directly.

GET /historicalBlockTradingRewards/{address} and /fundingPayments?address={address} for the past 30 days and store both for reconciliation

Agent-Driven Market Lookups via Jentic

An AI agent answering a user question like 'what's my current PnL on dYdX' calls the Indexer through Jentic. The agent searches Jentic for 'get historical PnL for a dYdX subaccount', loads the input schema, and executes /historical-pnl with the user's address - no wallet keys are involved because the API is read-only.

Use Jentic to search 'get the order book for a dYdX perpetual market', load the operation, and execute it for ticker BTC-USD

Key Endpoints

49 endpoints — jentic publishes the only available openapi specification for the dydx indexer api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/perpetualMarkets

List all perpetual markets

GET

/orderbooks/perpetualMarket/{ticker}

Fetch the order book for a perpetual market

GET

/candles/perpetualMarkets/{ticker}

Fetch candles for a perpetual market

GET

/addresses/{address}/subaccountNumber/{subaccountNumber}

Get a subaccount for an address

GET

/fills

List fills filtered by subaccount and market

GET

/orders

List orders for a subaccount

GET

/historical-pnl

Retrieve historical PnL for a subaccount

GET

/compliance/screen/{address}

Screen an address for compliance

GET

/perpetualMarkets

List all perpetual markets

GET

/orderbooks/perpetualMarket/{ticker}

Fetch the order book for a perpetual market

GET

/candles/perpetualMarkets/{ticker}

Fetch candles for a perpetual market

GET

/addresses/{address}/subaccountNumber/{subaccountNumber}

Get a subaccount for an address

GET

/fills

List fills filtered by subaccount and market

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Indexer requires no credentials, so there is nothing to vault. Jentic still mediates the call, applies usage policy, and centralises rate-limit handling so an agent doesn't need bespoke retry logic.

Intent-based discovery

Agents search Jentic by intent (e.g. 'get historical PnL for a dYdX subaccount') and Jentic returns the matching Indexer operation with its input schema and pagination shape.

Time to first call

Direct integration: 1-2 days to handle pagination, error shapes, and response schemas across 49 endpoints. Through Jentic: under 30 minutes - search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Dux-Soup LinkedIn Activity API

Unrelated automation surface; included only as cross-domain reference - not a finance alternative

Do not pick this for trading data; included for breadth - choose dYdX Indexer for any market read

Complementary

Visma e-conomic API

Pair with dYdX trading data to record realised PnL into accounting ledgers

Choose Visma e-conomic when the next step after reading PnL is to post journal entries into accounting

Complementary

dweet.io

Lightweight publish/listen layer for streaming derived metrics from dYdX reads to a dashboard

Use dweet.io to broadcast derived metrics (e.g. funding rate snapshot) to clients without running a websocket server

FAQs

Specific to using dYdX Indexer API API through Jentic.

Why is there no official OpenAPI spec for the dYdX Indexer API?

dYdX does not publish an OpenAPI specification for the v4 Indexer. Jentic generates and maintains this spec so that AI agents and developers can call the dYdX Indexer API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the dYdX Indexer API use?

The Indexer is fully read-only and unauthenticated - no API key or signed request is required for any endpoint, including subaccount and PnL queries. Trading actions on dYdX v4 are submitted to validators with on-chain signatures and are not part of this Indexer API.

Can I place orders with the dYdX Indexer API?

No. The Indexer only reads chain state - to place or cancel orders you must broadcast signed transactions to the dYdX v4 validator network using the dYdX client libraries. Use endpoints like GET /orders and GET /orders/{orderId} on the Indexer to confirm the status of orders submitted that way.

What are the rate limits for the dYdX Indexer API?

The OpenAPI spec does not declare a numeric rate limit. The public dYdX-hosted Indexer at indexer.dydx.trade applies fair-use throttling per IP - high-volume traders typically run their own Indexer instance to avoid hitting limits.

How do I fetch dYdX market data through Jentic?

Run pip install jentic, search for 'get the order book for a dYdX perpetual market', load the operation for GET /orderbooks/perpetualMarket/{ticker}, then execute it with the ticker (for example ETH-USD) as the path parameter. No credentials are required because the Indexer is open.

Does the dYdX Indexer return websocket data?

This OpenAPI spec only documents the REST surface (49 endpoints). dYdX also exposes a websocket channel for live order book and trade updates, but it is not part of this REST API - use the REST endpoints listed here for snapshot reads and reconciliation.