dYdX API MCP. Run trades and analyze perpetuals from your agent.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
dYdX (Decentralized Perpetual Exchange API) provides full access to the dYdX v4 infrastructure. Use this server to monitor markets, check balances, and execute trades on the leading decentralized perpetual exchange directly from your AI agent.
Access L2 orderbooks, historical OHLCV data, and manage open positions using natural language commands.
What your AI agents can do
V3 create order
Places a new order on dYdX v3.
V3 get accounts
Gets account information on dYdX v3.
V3 get orderbook
Retrieves the current L2 orderbook for a dYdX v3 market.
Retrieves your total equity, available balances, and a list of all open trading positions on dYdX v4.
Places new limit or market orders and cancels existing ones using the dYdX v4 endpoint.
Fetches the current L2 orderbook for any specified dYdX v4 market pair.
Retrieves OHLCV candlestick data for technical analysis across various timeframes.
Gets recent public trade records or lists the specific fills associated with your account.
Fetches specific details and 24-hour rolling statistics for a selected dYdX v4 market pair.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
dYdX API: 16 Tools for Crypto Trading
Use these 16 tools to manage every aspect of your trading life—from checking balances to placing complex orders and analyzing market depth.
019e5d14v3 create order
Places a new order on dYdX v3.
019e5d14v3 get accounts
Gets account information on dYdX v3.
019e5d14v3 get orderbook
Retrieves the current L2 orderbook for a dYdX v3 market.
019e5d14v3 list markets
Lists all available markets on dYdX v3.
019e5d14v4 cancel order
Cancels an open order by ID on dYdX v4.
019e5d14v4 create order
Places a new limit or market order on dYdX v4.
019e5d14v4 get account
Gets your account balances, positions, and equity on dYdX v4.
019e5d14v4 get candles
Retrieves historical OHLCV data for a dYdX v4 market.
019e5d14v4 get market
Gets specific details for a dYdX v4 market (e.g., BTC-USD).
019e5d14v4 get orderbook
Retrieves the current L2 orderbook for a dYdX v4 market.
019e5d14v4 get stats
Gets 24-hour trading statistics for a dYdX v4 market.
019e5d14v4 get trades
Retrieves recent public trades for a dYdX v4 market.
019e5d14v4 list fills
Lists recent trade fills for your account on dYdX v4.
019e5d14v4 list markets
Lists all available perpetual markets on dYdX v4.
019e5d14v4 list orders
Lists all active and historical orders for your account on dYdX v4.
019e5d14v4 list positions
Lists all open positions on dYdX v4.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with dYdX (Decentralized Perpetual Exchange API), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
dYdX API - Trade & Analyze Crypto Perpetuals
This server gives your AI agent full access to the dYdX v4 infrastructure. You can monitor markets, check balances, and execute trades on the leading decentralized perpetual exchange straight from your agent. You'll get access to L2 orderbooks, historical OHLCV data, and the ability to manage open positions using nothing but natural language commands.
Managing Positions and Balances
Your agent can get your total equity, available balances, and a list of all your open trading positions using v4_get_account and v4_list_positions. You can also see all your active and historical orders with v4_list_orders and check your recent trade fills with v4_list_fills.
Executing Trades and Orders
When you're ready to trade, your agent can place new limit or market orders using v4_create_order and you can cancel existing ones with v4_cancel_order. You can also list every available perpetual market with v4_list_markets or check specific market details with v4_get_market.
Analyzing Real-Time Market Depth and History
To check real-time market depth, your agent retrieves the current L2 orderbook for any dYdX v4 market using v4_get_orderbook. For technical analysis, you can pull historical OHLCV candlestick data for a market using v4_get_candles, and you can check recent public trades for a market with v4_get_trades.
Getting Market Stats and Details
You can get 24-hour trading statistics for a dYdX v4 market pair using v4_get_stats, and you can also see all recent trade fills for your account with v4_list_fills. To see all available markets on dYdX v3, your agent can use v3_list_markets and you can list all available perpetual markets on dYdX v4 with v4_list_markets.
General Account Access
For dYdX v3, your agent can get account information using v3_get_accounts and you can also place a new order on dYdX v3 using v3_create_order and get the current L2 orderbook for a dYdX v3 market with v3_get_orderbook.
How dYdX API MCP Works
- 1 Subscribe to the dYdX server and provide your API credentials (Key, Secret, Passphrase).
- 2 Your AI client sends a natural language request (e.g., 'What is the orderbook for BTC-USD?').
- 3 The server executes the required tool (e.g.,
v4_get_orderbook) and returns the structured data to your agent.
The bottom line is: you use natural language to command the server, and the server executes the trade or data retrieval using your credentials.
Who Is dYdX API MCP For?
This is for quantitative developers and crypto analysts who need to test strategies and analyze markets without leaving their IDE or terminal. If you're tired of switching between a charting platform, a terminal, and a spreadsheet, this server lets you manage everything in one place.
Runs backtests and strategy simulations by calling v4_get_candles and v4_create_order directly from their development environment.
Checks live market depth and account status by querying v4_get_orderbook and v4_get_account to inform reports.
Places and monitors trades by calling v4_create_order or v4_cancel_order when a signal hits.
What Changes When You Connect
- See your full account status instantly. Use
v4_get_accountto check your total equity and current buying power without navigating to a separate dashboard. - Analyze market depth in real-time.
v4_get_orderbookpulls the L2 orderbook, showing the best bid and ask levels for immediate liquidity assessment. - Test strategies with historical data.
v4_get_candlespulls OHLCV data for any market, letting you run backtests directly in your agent's memory. - Manage positions in one flow. You can check your status with
v4_list_positionsand place a trade usingv4_create_ordersequentially. - Track all your activity. Use
v4_list_fillsto see exactly which trades were executed and when, providing a clear audit trail. - Get quick market context.
v4_get_statsfetches 24-hour statistics, giving you immediate insight into market volatility or volume changes.
Real-World Use Cases
Monitoring a volatile pair
A trader sees a sudden price shift. Instead of opening the exchange UI, they prompt their agent: 'What is the current orderbook for ETH-USD, and what are the 24h stats?' The agent calls v4_get_orderbook and v4_get_stats instantly, providing immediate liquidity and context for a decision.
Backtesting a new strategy
A quant wants to validate a moving average crossover. They ask the agent to fetch historical data for BTC-USD using v4_get_candles, then use that data to calculate signals, and finally recommend placing a trade using v4_create_order.
Auditing a missed trade
A developer needs to know why a trade didn't execute. They ask the agent to list all recent fills using v4_list_fills and check the account state with v4_get_account. This quickly pinpoints if the issue was position limits or a failed order.
Listing all trading options
A new user needs to know what pairs are available. They simply ask the agent to call v4_list_markets, getting a full list of perpetual markets, and then v4_get_market for details on a specific pair.
The Tradeoffs
Manual State Tracking
Manually checking the exchange UI, copying the position ID, and pasting it into a separate order cancellation form.
→
Tell your agent: 'Cancel my open order for BTC-USD.' The agent calls v4_list_orders to find the ID, then executes v4_cancel_order in one step.
Using Outdated APIs
Sticking to old versions of tools (like v3_get_orderbook) when better, modern v4 tools exist.
→
Always use the v4 endpoints. For instance, use v4_get_orderbook instead of v3_get_orderbook to ensure you get the latest data and functionality.
Sequential Calls for Context
Calling v4_get_candles for data, then calling v4_get_stats for context, and only then deciding on a trade.
→
Combine context gathering. Ask the agent to 'Give me the 24h stats and the orderbook for ETH-USD.' This triggers both v4_get_stats and v4_get_orderbook in a single query.
When It Fits, When It Doesn't
Use this server if your workflow requires executing trades or analyzing crypto market data (orderbooks, historical candles, balances). It handles the entire lifecycle: data retrieval, analysis, and execution. Don't use this if you only need to read a static list of markets; v4_list_markets is enough. You need the full suite if you must check your account balance (v4_get_account) before placing an order (v4_create_order). Never try to manually reconcile state changes across different tools; let the agent handle the sequence using the full API suite.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by dYdX. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 16 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking market depth and historical data is usually a multi-tab, multi-click process.
Today, you have to jump between the charting tool, the order book page, and the account summary. You copy the pair name from one tab, paste it into another to get the L2 orderbook, and then open a third tab to view the 24h stats. It’s slow, and you lose context in the copy/paste cycle.
With this MCP server, you ask your agent one question: 'Give me the full picture of BTC-USD.' The agent runs `v4_get_orderbook` and `v4_get_stats` simultaneously, giving you immediate, structured data feeds—no clicking required.
v4_create_order: Execute trades and manage balances with dYdX.
Previously, placing a trade meant logging in, selecting the asset, choosing limit/market, filling out the size, and confirming the order manually. If you made a mistake, you had to navigate back to cancel it, which was another set of clicks.
Now, you simply tell your agent: 'Place a limit order for 0.05 ETH at $2,450.' The agent calls `v4_create_order` and manages the entire state, making the transaction as simple as a conversation.
Common Questions About dYdX API MCP
How do I check my account balance using v4_get_account? +
Call v4_get_account. This tool returns your total equity, available buying power, and current open positions in one structured response. It’s the best place to start before any trade.
Can I use v4_get_orderbook to see deep liquidity? +
Yes, v4_get_orderbook fetches the current L2 orderbook. It shows the best bids and asks, plus the depth of liquidity within the market.
What is the difference between v4_create_order and v4_get_orderbook? +
v4_create_order executes a transaction by placing an order. v4_get_orderbook is purely informational; it just reads the current state of the market depth.
How do I list all available markets with v4_list_markets? +
Use v4_list_markets. This tool gives you a comprehensive list of all perpetual markets currently active on the dYdX v4 exchange.
What does v4_get_candles do, and how do I get historical data? +
The v4_get_candles tool fetches historical OHLCV data for a specific dYdX v4 market. You need to specify the market pair and the desired time range (start/end time) to get the candlesticks you need.
How do I list my open positions using v4_list_positions? +
v4_list_positions returns a list of all currently open positions on dYdX v4. This lets you see the size, entry price, and current P&L for every active trade.
Which tool should I use to track recent trades and fills? +
Use v4_get_trades to get recent public trades, and v4_list_fills to list your account's specific trade fills. This distinction helps you track both market activity and your own executed transactions.
What is the purpose of v4_get_stats? +
The v4_get_stats tool retrieves 24-hour rolling statistics for a dYdX v4 market. This provides key metrics like total volume, high/low prices, and trading activity over the last day.
Can I check my current open positions and account balance? +
Yes. You can use v4_list_positions to see all active trades and v4_get_account with your address to retrieve balances and equity.
How do I get the latest market price and orderbook depth? +
Use the v4_get_market tool for general info or v4_get_orderbook for the current L2 state of any specific market like BTC-USD.
Is it possible to place or cancel trades through the AI? +
Yes. The v4_create_order tool allows you to place limit or market orders, and v4_cancel_order lets you cancel them using their Order ID.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Mercury
Bank smarter for your startup with FDIC-insured accounts, treasury management, and business banking built for tech companies.
Binance (Crypto Market)
Track cryptocurrency markets via Binance — get real-time prices, monitor 24h trends, analyze market movers, and audit trading volumes directly from any AI agent.
ECB Monetary — Money Supply, Yield Curves & Banknotes
Eurozone monetary data: M1, M2, and M3 money supply aggregates, government bond yield curves from 3 months to 30 years, full yield curve snapshots, and euro banknotes in circulation statistics from the European Central Bank.
You might also like
Object Hash Engine
Generate deterministic SHA-256 fingerprints of any JSON object. Keys are automatically sorted so {b:2,a:1} and {a:1,b:2} always produce the exact same hash. Essential for deduplication.
Drata
Automate compliance and security via Drata — monitor controls, track personnel onboarding, audit policies, and verify cloud asset security directly from any AI agent.
Linear (Issue Tracking & PM)
Manage product development via Linear — track issues, monitor sprint cycles, and audit team projects.