okx-trading-exe_skill

Overview

This skill is a standardized adapter gateway for the OKX exchange that executes trading actions and queries across both OKX Live and Demo environments. It is stateless and focused only on execution and data retrieval — it does not include strategy logic or other exchange integrations. Use it as a reliable execution handle for placing market/limit orders and fetching balances, positions, and recent trades.

How this skill works

The skill reads API credentials from a local .env file and connects to the chosen provider (okx_demo or okx_live). It exposes a simple CLI entrypoint that accepts an action name and options, performs the requested API call on OKX, and returns standardized JSON or clear stdout output. If credentials are missing, the calling agent must pause and request the API_KEY, API_SECRET, and PASSPHRASE from a human operator to populate .env before retrying.

When to use it

• Execute market or limit buy/sell orders on OKX demo or live accounts
• Query account balances and available funds programmatically
• Retrieve current open positions for portfolio reconciliation
• Pull recent trade history for auditing or downstream processing
• Integrate as an execution plug-in for an external trading strategy agent

Best practices

• Store API_KEY, API_SECRET, and PASSPHRASE only in a secure .env file; never pass keys as CLI parameters
• Always validate the provider flag: use okx_demo for testing and okx_live for real trading
• Use standardized symbol format with a dash (e.g., BTC-USDT); avoid slash formats
• Route outputs through parsers that expect JSON or clean stdout to make downstream automation reliable
• Treat this skill as execution-only — perform strategy calculations and risk checks externally before calling it

Example use cases

• Place a market buy in the demo environment to test order flow: place_market_order --provider okx_demo --symbol BTC-USDT --side buy --size 50
• Submit a limit sell on live after external signal: place_limit_order --provider okx_live --symbol BTC-USDT --side sell --size 0.1 --price 62000
• Fetch current positions for a risk manager: get_positions --provider okx_live
• Pull account balances to compute portfolio exposure: get_balance --provider okx_demo
• Retrieve recent trades for reconciliation or to feed a trade blotter: get_recent_trades --provider okx_live