OKX Wallet API Explained: Features, Pricing, and How to Integrate

Developers searching for "okx wallet api" usually want one of three things: a way to build or integrate a multi-chain wallet, a backend for onchain data queries, or an API to handle transaction signing and broadcasting across many networks. OKX offers all of these through its Onchain OS developer platform — formerly known as OKX Web3 Build — which bundles a Wallet API, a Trade API (DEX aggregator), a Market API, and a Payments API into a single suite.

This guide walks through what the OKX Wallet API actually does, how the different API modules differ, what you pay (and where it's free), and how to decide whether it fits your project.

What the OKX Wallet API Actually Is

The OKX Wallet API is part of Onchain OS, OKX's developer-facing Web3 infrastructure layer. It's not a single endpoint — it's a collection of REST and WebSocket APIs that let you build wallet functionality, query onchain data, aggregate DEX liquidity, and handle transaction signing without running your own RPC nodes for every chain.

OKX positions Onchain OS as "Web3 infrastructure for the AI era," and it ships in two integration flavors:

• Skills / MCP Server — natural-language driven, designed for AI agents. An agent can call Onchain OS capabilities through conversation rather than manual API wiring.

• Open API — the traditional programmatic route. You authenticate with an API key and HMAC signature, then call REST endpoints directly.

For most developers searching "okx wallet api," the Open API path is the relevant one. The Skills layer is geared toward agent builders.

Core API Modules

Wallet API

The Wallet API is the backend for building multi-chain EOA (externally owned account) wallets or embedding wallet features into a dApp. According to OKX's own developer documentation, it covers:

• Account management and address derivation across 60+ chains

• Token balance queries (specified, total, aggregated)

• Risk token filtering (honeypot and blacklist detection)

• LP token recognition

• DeFi position tracking (1,900+ protocols across 54+ chains)

• NFT balances with metadata and market data

• UTXO queries for Bitcoin and similar chains

• Transaction signing, message signing, and broadcasting

• Gas estimation and pre-execution simulation

• Full-cycle transaction status tracking with webhook notifications

The Wallet API itself is free to use. OKX states this explicitly in its developer materials, framing it as a way to lower the barrier for multichain development. You still pay gas onchain, of course, but there's no per-call fee from OKX for the wallet data and signing endpoints.

Trade API (DEX Aggregator)

The Trade API is the DEX aggregation engine behind OKX DEX. It scans liquidity across 500+ DEXs and 25+ chains (the exact count has grown over time — the changelog shows ongoing additions like HyperEVM, Ink, Robinhood, Pharos, and Plasma through 2025 and 2026), then returns optimized swap routes with smart order splitting.

A typical swap flow looks like this:

1. Call /supported/chain to get the list of available networks.

2. Call /aggregator/all-tokens to find supported tokens on a given chain.

3. Request a /quote for the desired swap.

4. Get user authorization via /approve-transaction.

5. Call /swap to build the transaction calldata.

6. Broadcast the transaction to the chain.

The Trade API supports advanced features: MEV protection on Solana, Ethereum, BSC, and Base; excludePoolAddresses to skip specific liquidity pools; assetAwareRouting for stable-route swapping; Jito bundle compatibility on Solana via forJitoBundle; and an exactOut reverse-quoting mode for specifying output amount. Partners can also set a referral fee per swap — up to 3% on most chains, up to 10% on Solana — and collect it at a designated address.

Market API

The Market API provides real-time and historical market data: token prices, trades, candles, holder statistics, portfolio PnL, smart money tracking, meme pump signals, leaderboard data, and onchain explorer-style queries (blocks, transactions, logs). It pulls from both DEXs and CEXs across multiple ecosystems.

This is the only module with a formal tiered pricing structure, covered in detail below.

Payments API

Built on the x402 protocol, the Payments API handles autonomous onchain billing — primarily for AI agents that need to pay for data or services without manual intervention. It's pay-as-you-go and currently live on X Layer, with Solana, BNB Chain, and Base marked as "coming soon" in the supported-networks documentation.

Agentic Wallet

A newer addition, the Agentic Wallet is aimed at AI agents that need their own self-custodial wallet. Key generation, storage, and signing all happen inside a Trusted Execution Environment (TEE) — OKX can't access the private key. Each developer account can run up to 50 sub-wallets in parallel for multi-strategy execution. Sign-in is flexible: email, Google, or Apple, with no API key required to start.

Supported Chains

The network list is long and actively expanding. As of the most recent changelog entries (August 2026), the Open API supports:

EVM chains: Ethereum, BNB Chain, Base, Arbitrum One, Optimism, Polygon, Polygon zkEVM, Avalanche C, Fantom, Scroll, zkSync Era, Linea, Blast, Mantle, Manta Pacific, Merlin, Metis, Conflux, Cronos, Sonic, ZetaChain, Uni Chain, HyperEVM, Ink, Pharos, Plasma, Robinhood, and X Layer (OKX's own L2).

Other ecosystems: Bitcoin, Solana, SUI, Ton, Tron.

The Agentic Wallet has a smaller but overlapping set focused on the most active networks. Not every module is available on every chain — for example, Payments is only live on X Layer so far — so check the supported-networks page for the current matrix before building.

Authentication and Getting Started

All Open API requests require four headers:

• OK-ACCESS-KEY — your API key

• OK-ACCESS-TIMESTAMP — UTC timestamp in ISO format (must be within 30 seconds of server time)

• OK-ACCESS-PASSPHRASE — the passphrase you set when creating the key

• OK-ACCESS-SIGN — HMAC SHA256 signature, Base64-encoded

The signature is generated by concatenating the timestamp, HTTP method (uppercase), request path, and request body, then signing with your secret key. OKX provides Postman and JavaScript examples in the docs.

To get keys, you go through the Web3 Developer Portal:

1. Connect a wallet (OKX Wallet recommended, but others work) and sign to verify ownership.

2. Link an email and phone number, complete verification.

3. Create a project — each developer account supports up to 3 projects, each with up to 3 API keys.

4. Generate an API key with a passphrase, then view and securely store the secret key (it's only shown once).

If your region doesn't appear in the phone country list, OKX notes that the region is likely restricted from API services.

Pricing: Full Breakdown of All Public Tiers

OKX doesn't charge for the Wallet API. The cost lives in two places: the Trade API (DEX aggregation) and the Market API (market data). Each has its own tier structure, and they're billed independently.

Wallet API — Free

No per-call fee. No subscription. You can build and run a multichain wallet backend without paying OKX anything. This is the entry point for most "okx wallet api" searches, and it's genuinely free at the API layer.

Trade API (DEX Aggregator) Tiers

The Trade API has three tiers. There's no fixed monthly subscription price listed — instead, the cost is tied to positive slippage and revenue sharing.

Trial Tier

• Price: No upfront fee. OKX keeps positive slippage (when a trade executes better than quoted) as its infrastructure fee, capped at 10% of the trade amount.

• Rate limit: 1 request per second by default, up to 5 RPS on review.

• Duration: Valid for 60 days from API key creation.

• Features: Access to selected (standard) API endpoints only.

• Best for: Prototyping and evaluation before committing to a paid tier.

Start-up Tier

• Price: 20% revenue share on partner fees you charge users. If you don't configure a partner fee, OKX keeps positive slippage instead (capped at 10% of trade value).

• Rate limit: 2–50 RPS (correlated with trading volume).

• Features: Access to most advanced API endpoints, standard technical and growth support, optional access to keep positive slippage as your own revenue (on approval).

• Note: Partners with monthly trading volume above $10M must contact BD to move to Enterprise.

• Best for: Live dApps and wallets that have moved past prototyping and need higher throughput.

Enterprise Tier

• Price: Customized fee structure, negotiated via contract.

• Rate limit: Customized RPS based on needs.

• Features: All advanced endpoints, customized feature development (on approval), dedicated technical and growth support, full control over positive slippage (keep it or pass to users).

• Best for: High-volume aggregators, CEX-integrated swaps, and platforms with specialized requirements.

To upgrade tiers or raise rate limits, you join the OKX DEX API Discord or email dexapi@okx.com.

👉 Start with the Trial tier and get 20% off trading fees on OKX

Market API — x402 Pay-Per-Call

For developers who want to pay only for what they use, the Market API offers a pay-per-call model using the x402 payment protocol. Payments are made in USDG or USDT on the X Layer network.

Free API endpoints

• Price: $0, no quota limit.

• Includes: supported-chain queries, index price (current and historical), balance queries, transaction history by address, and basic explorer endpoints (address, transaction, block, log supported-chains).

• Best for: Bootstrap queries and basic balance/price lookups.

Basic API

• Price: 100,000 free calls per month, then $0.0001 per additional call.

• Includes: market price, trades, candles, top liquidity, hot tokens, token search, basic token info, latest portfolio PnL, DEX history, similar-token meme queries, and most onchain-data explorer endpoints (block lists, transaction lists, logs by address or transaction, info details).

• Best for: Low-frequency market data apps, dashboards, and lightweight agent applications.

Premium API

• Price: 100,000 free calls per month, then $0.0002 per additional call.

• Includes: advanced token info, historical candles, token holders, price info, portfolio overview and recent PnL, top traders, signal lists, leaderboards, meme pump token lists/details/dev info/bundle info/aped wallets, bubble map cluster data, and address balance history.

• Best for: Quantitative trading platforms, smart money tracking, and analytics-heavy products.

Market API — Subscription Plans

If you prefer predictable billing over per-call signing, OKX offers six subscription tiers. All paid tiers support all channels including WebSocket; the Free tier does not. Subscriptions auto-renew and quotas reset on the 1st of each month. First-time subscribers or upgrades are prorated for the remaining days in the current cycle.

Free

• Monthly price: $0

• Basic quota: 100,000 calls/month

• Premium quota: 100,000 calls/month

• Channels: No WebSocket

• Best for: Testing and small projects.

Starter

• Monthly price: $99

• Basic quota: 2,000,000 calls/month

• Premium quota: 600,000 calls/month

• Channels: All

• Best for: Small dApps with moderate data needs.

Growth

• Monthly price: $199

• Basic quota: 5,000,000 calls/month

• Premium quota: 2,000,000 calls/month

• Channels: All

• Best for: Growing wallets and analytics tools.

Scale

• Monthly price: $399

• Basic quota: 20,000,000 calls/month

• Premium quota: 10,000,000 calls/month

• Channels: All

• Best for: Production platforms with heavy data consumption.

Pro

• Monthly price: $599

• Basic quota: 50,000,000 calls/month

• Premium quota: 20,000,000 calls/month

• Channels: All

• Best for: High-traffic applications and data-intensive agents.

Enterprise

• Monthly price: Custom

• Basic quota: Unlimited

• Premium quota: Unlimited

• Channels: Unlimited

• Best for: Large-scale integrations with negotiated terms.

👉 Compare plans and sign up on OKX

How to Decide Which API You Need

If your goal is building a wallet or querying balances, the Wallet API is the starting point and it's free. You don't need a Trade or Market subscription to use it.

If you want to add swap functionality — letting users trade tokens inside your app — you need the Trade API. Start with the Trial tier to test routing quality and latency on the chains you care about, then move to Start-up once you're in production and need higher RPS.

If you're building an analytics dashboard, portfolio tracker, or agent that consumes market data, the Market API is the right module. The Free tier handles basic queries; the Basic and Premium endpoints cover deeper analytics. Choose pay-per-call if your usage is sporadic, or a subscription if you have steady, predictable volume.

The Agentic Wallet sits on top of all this for AI-native use cases where an agent needs autonomous wallet control with TEE-secured signing.

Recent Changes Worth Knowing

The Onchain OS changelog moves fast. A few notable updates from the past year that affect API users:

• Trade API upgraded to V6 in September 2025, with a new routing algorithm using Directed Acyclic Graphs for smarter order splitting.

• MEV protection added on Solana, Ethereum, BSC, and Base.

• Intent swap API now supports EIP-1271 contract signatures (July 2026).

• New chains added throughout 2025–2026: HyperEVM, Ink, Robinhood, Pharos, Plasma, Monad.

• Market API added WebSocket push channels (March 2026) for real-time streaming.

• Social Analytics API launched (May 2026) for crypto social media data.

• Trenches APIs added to Market API for meme trade and "golden dog" tracking.

If you're integrating now, check the changelog before locking in endpoint versions — OKX has been updating router addresses and parameter names regularly.

Frequently Asked Questions

Is the OKX Wallet API really free?

The Wallet API endpoints for balance queries, signing, and transaction management carry no per-call fee from OKX. You pay onchain gas for transactions, but not for the API calls themselves. The Trade API and Market API have their own pricing.

Do I need an OKX exchange account to use the API?

No. You create a developer account through the Web3 Developer Portal by connecting a wallet and verifying an email and phone number. The developer account is separate from an exchange trading account, though both live under the OKX umbrella.

What payment methods does the Market API accept?

Both pay-per-call and subscription billing require USDG or USDT on the X Layer network. No fiat or credit card options are listed in the documentation.

Can I charge my own users a fee on swaps?

Yes. Through the Trade API's partner fee feature, you can set a feePercent (up to 3% on most chains, up to 10% on Solana) and a feeReceivingAddress per swap. On the Start-up tier, OKX takes 20% of that partner fee as its infrastructure cut.

How many chains does the Wallet API support?

OKX advertises 60+ chains for the Wallet API, including 50+ EVM networks, 10+ UTXO chains, and Solana, Tron, and SUI. The Trade and Market APIs have slightly different coverage — check the supported-networks page for the exact matrix per module.

What's the rate limit on the free Trade API tier?

1 request per second by default, expandable to 5 RPS on review. The 60-day trial window starts when you create your API key.

Final Take

The OKX Wallet API is a solid choice if you're building a multichain wallet or dApp and want to skip running RPC infrastructure for dozens of networks. The free Wallet API layer is genuinely free, the Trade API's trial period lets you evaluate DEX aggregation quality before paying, and the Market API's hybrid pay-per-call and subscription model gives flexibility depending on your usage pattern.

Where OKX differs from alternatives like 0x or 1inch is breadth — it covers more chains (including UTXO and heterogeneous chains like Solana and Ton) and bundles wallet, trade, market, and payments into one platform. The trade-off is that the pricing is more complex, with slippage-based fees on the Trade side and a six-tier subscription ladder on the Market side.

If your project is EVM-only and focused narrowly on swap routing, a single-purpose DEX API might be simpler. If you need wallet functionality plus swaps plus market data across many chain types, Onchain OS is built for exactly that.

👉 Open an OKX account with 20% commission rebate and start building