OKX API

Name: OKX API
Brand: OKX API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey49 EndpointsREST

For Agents

Place and cancel orders on OKX, read account balances and positions, and pull market data for spot, futures, swaps, and options.

Install Jentic One Beta

Connect the OKX API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OKX API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with OKX API.

Place limit, market, and conditional orders across spot, margin, futures, and swaps

Cancel single or batched open orders by order ID or client-supplied ID

Read account balance, positions, and position-risk per instrument

GET STARTED

Start building with OKX API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use OKX API for, with concrete tasks.

★ Algorithmic trading execution

Execute a trading strategy on OKX by placing, amending, and cancelling orders programmatically. The trade endpoints accept a clOrdId so each order has a stable client-side reference, and the position-risk endpoint feeds the strategy's risk module. Latency-sensitive setups should pair this REST surface with OKX's WebSocket feeds for live market data.

Place a limit buy order for 0.1 BTC-USDT at a specified price and confirm the order ID returned by the exchange

Portfolio monitoring and reporting

Pull balances, open positions, and recent fills to feed a portfolio dashboard or daily P&L report. The account/balance, account/positions, and account/bills endpoints together give a complete picture of holdings, mark-to-market exposure, and historical activity. A scheduled job can compile this into a CSV or BI table within seconds.

Fetch the current balance, open positions, and the last 24 hours of bills, then compile a daily P&L summary

Market-data analytics

Quants and researchers pull candlesticks, ticker, and order-book depth from OKX to backtest strategies and build market-microstructure analytics. The market-data endpoints expose multiple resolutions (1m to 1D) and venue-side ticker fields like 24h volume that are critical for liquidity modelling.

Pull 30 days of 1-hour candles for BTC-USDT and compute the realised volatility

Sub-account treasury automation

Funds and prop desks operating multiple OKX sub-accounts use the asset transfer endpoints to rebalance USDT and BTC between them, and the funding endpoints to move funds between trading and funding wallets. This automates routine treasury tasks that previously required manual UI clicks per sub-account.

Transfer 1000 USDT from the funding account to the trading account and confirm the transfer reference

AI agent crypto assistant via Jentic

An AI agent acting as a crypto-trading assistant uses Jentic to call OKX without holding the four-header signed-request scheme directly. The agent searches Jentic for an intent like 'place an OKX limit order', loads the schema, and executes - Jentic handles the API key, secret signing, timestamp, and passphrase headers from the encrypted vault.

Search Jentic for 'OKX place order', load the schema, and execute a limit buy order for a user-specified instrument and amount

Key Endpoints

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

METHOD

PATH

DESCRIPTION

POST

/api/v5/trade/order

Place an order

POST

/api/v5/trade/cancel-order

Cancel an order by orderId

GET

/api/v5/account/balance

Get account balance

GET

/api/v5/account/positions

List open positions

GET

/api/v5/account/bills

List recent account bills and fills

GET

/api/v5/account/instruments

List instruments tradable on the account

GET

/api/v5/account/account-position-risk

Get position risk per instrument

POST

/api/v5/trade/order

Place an order

POST

/api/v5/trade/cancel-order

Cancel an order by orderId

GET

/api/v5/account/balance

Get account balance

GET

/api/v5/account/positions

List open positions

GET

/api/v5/account/bills

List recent account bills and fills

Why Jentic?

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

Credential isolation

Your OKX API key, secret, and passphrase are stored once, encrypted, by your own Jentic One instance, which computes the OK-ACCESS-SIGN HMAC at execution time. The raw secret and passphrase never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'place a limit order' or 'check my account balance', and Jentic returns the matching OKX operation with its parameters typed in the input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using OKX API through Jentic.

Why is there no official OpenAPI spec for OKX API?

OKX does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call OKX API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the OKX API use?

OKX uses an API key with four signed headers: OK-ACCESS-KEY, OK-ACCESS-SIGN (HMAC-SHA256 of the request payload), OK-ACCESS-TIMESTAMP, and OK-ACCESS-PASSPHRASE. Through Jentic, the secret and passphrase are stored encrypted in the vault and the signature is computed at request time, so the agent never holds the raw secret.

Can I place a perpetual swap order with the OKX API?

Yes. POST to /api/v5/trade/order with instId set to a swap symbol (for example BTC-USDT-SWAP), tdMode set to cross or isolated, and the order side, type, and size. The same endpoint handles spot, margin, futures, swaps, and options - instId determines the instrument.

What are the rate limits for the OKX API?

OKX applies per-endpoint rate limits, typically expressed as N requests per 2 seconds per UID or IP. Limits vary - order-placement endpoints are more constrained than read-only market-data endpoints. Response headers include the remaining quota; back off on 429.

How do I cancel all open OKX orders through Jentic?

Search Jentic for 'OKX cancel orders', load the schema for the cancel-orders operation, and execute with instId or a list of orderIds. The endpoint accepts batched cancellations, so a single call clears the open book for one symbol.

Does the OKX API support sub-accounts?

Yes. The funding endpoints support transfers between sub-accounts and the parent account. Each sub-account has its own balances and positions, queryable via the standard /api/v5/account endpoints when authenticated as that sub-account.

Can I read market depth from the OKX API?

Yes. The market-data endpoints expose tickers, candlesticks at multiple resolutions, and order book depth. For real-time updates beyond REST polling, OKX offers WebSocket feeds - pair them when latency matters.

Can I limit what my agent is allowed to do with the OKX API?

Yes. Because your Jentic One instance is self-hosted, your own rules decide which OKX operations the agent may call. Since OKX carries instrument and order identifiers in the request body and query rather than the URL path, scoping is by operation: you can allow read-only calls like getting the account balance or listing positions while excluding order placement and cancellation. Placing an order via /api/v5/trade/order or cancelling one via /api/v5/trade/cancel-order is available to the agent only if you add that operation.

OKX API

Connect the OKX API to your agent

Capabilities

Start building with OKX API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs