OKX MCP. Trade and manage crypto accounts from natural language.
OKX MCP connects your AI agent directly to the OKX exchange, letting you monitor crypto markets and manage trades using natural conversation. Check asset balances, track complex positions across futures and margin accounts, and place immediate market orders—all without leaving your chat window.
Give Claude and any AI agent real-world access
Retrieve real-time liquid asset balances, allowing you to filter results by specific currencies.
Fetch a list of all crypto pairs and instrument types currently supported for trading on the exchange.
Track your current open trade positions, including details about margin or futures contracts.
Execute market or limit buy/sell orders using specific instrument IDs and desired sizes.
Change the parameters, like the size or price, of a trade order that hasn't executed yet.
Immediately cancel any open or unexecuted trade orders using their unique ID.
Ask an AI about this
Waiting for input…
What AI agents can do with OKX MCP: 6 Tools for Trading Mastery
Use these tools to check your account status, list available pairs, and execute complex trading actions directly through your agent.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using OKX MCPAmend Order
Changes the details of an existing trade order that is still pending or incomplete.
Get Balance
Retrieves your current available asset balances in your OKX trading account...
Cancel Order
Immediately cancels a trade order that has not been filled or executed yet.
Get Instruments
Lists all available trading pairs and instrument types (like spot, futures, etc.)...
Place Order
Initiates a new trade order, specifying the asset, market type, side, and size.
Get Positions
Retrieves detailed information about all your currently active open positions on the exchange.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with OKX, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by OKX. 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 CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The constant switching between trading portals drains focus and time.
Today, if you want to know your total liquid funds across three different assets, you open the exchange dashboard. Then, you switch tabs to check your futures positions. If you need to place a trade, you copy the instrument ID from one section and paste it into another order form. This cycle of opening, copying, switching, and confirming is tedious.
With this MCP, you keep everything in one conversation with your agent. You just ask for 'my current balances' or 'my open positions.' The system pulls that data instantly, showing you the full picture without a single click outside of your chat client.
OKX MCP: Execute trades and manage risk in conversation.
The manual steps that disappear are the need to copy unique IDs, navigate between spot/futures tabs, and manually reconcile your current cash balance against your active margin requirements. You don't have to switch between multiple separate web pages just to confirm if a trade is possible.
Now you talk to the exchange directly through your agent. The whole process of checking funds with get_balance, confirming positions via get_positions, and executing a new order using place_order happens as one continuous thought.
What OKX MCP does for your AI
This connection lets you treat your cryptocurrency portfolio like a spreadsheet, but talk to it instead of clicking through tabs. You can use the MCP to monitor markets and manage your holdings directly from any compatible AI client. Need to know what assets you have available right now? Ask for your current balances.
Want to place a trade? Simply tell your agent the action: buy 0.05 BTC on the spot market, or amend an existing limit order. You can also look up every instrument type available for trading—spot, margin, futures, and more. Whether you're a seasoned trader needing quick risk assessments or just checking your funds before making a deposit, this MCP provides real-time data access and execution capabilities right where you work.
Accessing these powerful tools through the Vinkius catalog means you connect once from any of your preferred AI clients and instantly gain control over complex financial workflows.
019e38cb-8c16-7303-a9cc-1288d66057fb How to set up OKX MCP
The bottom line is that your AI client acts as the middleman, translating natural language commands into secure API calls to OKX.
Subscribe to the OKX MCP and provide your exchange API Key, Secret Key, and Passphrase.
Select this MCP within your AI client's connection menu. Your agent establishes a secure link with OKX.
Tell your agent what you need—for example, 'What are my balances?' or 'Place a market buy order for 0.01 ETH.' The agent runs the required tool and gives you the result.
Who uses OKX MCP
This MCP is built for anyone who deals with crypto trading but hates context switching. If you're a portfolio manager tired of jumping between web dashboards and mobile apps, or a developer needing to test trade logic without writing boilerplate code, this tool saves hours.
Executes multiple trades in a single session by asking the agent to check positions, then place an order, and finally cancel another pending entry.
Quickly checks current asset balances and lists available instruments to determine which new pairs or contracts are viable for research.
Gets a rapid summary of risk exposure across different asset classes by requesting active positions, avoiding manual dashboard data compilation.
Benefits of connecting OKX MCP
Eliminate platform hopping. Instead of jumping between OKX’s web portal, mobile app, and spreadsheet to check balances, you simply ask your agent for your current funds using the get_balance tool.
Manage complex trades without writing code. You can tell the AI to place a market buy order or amend an existing limit order—it handles the specific parameters of the place_order tool instantly.
Instantly assess risk exposure. Get a clear overview of all open positions using get_positions, which is better than manually compiling data from separate futures and margin tabs.
Control your orders in real time. If you need to pull back or change an order before it fills, the cancel_order and amend_order tools let you do that with one simple command.
Broad market visibility. Use get_instruments to see every available crypto pair for spot, futures, or options trading without manually browsing the exchange’s listing pages.
OKX MCP use cases
Checking funds before a large trade
A user needs to know if they have enough liquid capital before executing a multi-asset strategy. They prompt their agent: 'Show me my current USDT and BTC balance.' The agent uses get_balance, giving the user immediate confirmation without logging into any separate banking or exchange dashboard.
Reacting to market moves
A trader sees a price spike and needs to move fast. They tell their agent: 'Place a limit sell order for 0.1 ETH at $3,500.' The agent uses place_order with the correct parameters, executing the trade instantly.
Auditing open risk
A portfolio manager needs to audit all active risks across different contracts. They ask: 'List all my active futures positions.' The agent runs get_positions and provides a consolidated report of sizes, entry prices, and unrealized PnL.
Correcting an error
A user accidentally placed an order with the wrong size. They prompt: 'Cancel my recent trade on BTC-USDT.' The agent uses cancel_order, preventing a costly mistake before the market moves again.
OKX MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Treating it like a static data lookup.
Asking the AI to 'list all crypto pairs.' This only gives you instrument names, but doesn't let you check if they are currently tradable or what your balance is for that asset.
Always pair data retrieval with action. First run get_instruments to see what's available, then use get_balance to confirm the funds needed before asking the agent to place_order.
Mixing up order IDs and instrument IDs.
Trying to cancel an order by just naming the asset (e.g., 'cancel BTC trade'). The system needs specific identifiers to ensure it cancels the correct, incomplete contract.
When canceling or amending, always provide the unique Order ID or Client Order ID alongside the instrument ID for guaranteed accuracy.
Over-relying on natural language alone.
Telling the agent to 'buy some crypto.' This is too vague and will fail because it doesn't know your intended trade mode (cash/cross) or exact size requirements.
Be specific. Use phrases like, 'Place a market buy order for 0.05 ETH on BTC-USDT with cash mode.'
When to use OKX MCP
Use this MCP if your workflow requires direct execution and real-time state management: checking current funds (get_balance), viewing open risk (get_positions), or immediately placing/modifying a trade (place_order, amend_order). Don't use it if you are only doing pure historical research; for deep academic analysis of market history, you need dedicated data warehousing tools. If your goal is simply to get a list of pairs without knowing which ones you can afford, just running get_instruments isn't enough—you still need the balance check first.
Frequently asked questions about OKX MCP
How do I check my OKX crypto balances using the OKX MCP? +
You use the get_balance tool. Just ask your agent for 'my current asset balances' or specify a currency like, 'What is my ETH balance?' The system will return your real-time liquid funds.
Can I manage futures trades with OKX MCP? +
Yes. You can use get_positions to view all active contracts and place orders for margin or cross modes using the place_order tool, making it suitable for advanced traders.
What if I need to change an order before it fills? +
You use amend_order. You simply tell your agent which incomplete order you want to change and what new parameters (like a different size or price) you want to set.
Does OKX MCP help me know what trades I can make? +
Yes, first run get_instruments. This tool lists all available trading pairs and instrument types that are currently supported on the exchange for your account.
Is OKX MCP only for US-based accounts? +
No. The connection works by integrating with your specific, authenticated OKX API keys, meaning it manages your personal portfolio regardless of your geographic location or account type.