OKX — exchange and Web3 Wallet, one workspace

OKX combines a top-tier derivatives exchange with a popular self-custody Web3 Wallet. We integrate both surfaces.

exchangeread-only sync Real-time

OKX has a dual presence — the centralized exchange (spot, perps, options) and the OKX Web3 Wallet (self-custody, multi-chain). Many users hold balances across both, and the accounting needs to reconcile transfers between them. The integration ingests both via the official APIs.

What the OKX integration does

Exchange ingest

Spot, perps, options under read-only API key.

OKX Web3 Wallet

Self-custody wallet activity tracked across supported chains.

Internal transfer reconciliation

Exchange ↔ Web3 Wallet transfers tagged as intra-organization.

The connection in 4 steps

01

Connect OKX exchange via read-only API key

Generate a read-only API key in OKX's account settings with permissions limited to trade history, funding, and account balance. No withdrawal permissions required or accepted.

02

Connect OKX Web3 Wallet via public address

Import the OKX Web3 Wallet address (or addresses) directly by pasting the public address. Wag3s reads on-chain activity across all supported chains — OKX Chain (X1), Ethereum, BNB Chain, and others.

03

Tag internal exchange ↔ wallet transfers

Withdrawals from the OKX exchange that land in the OKX Web3 Wallet are identified as intra-organization transfers and excluded from realized P&L calculations.

04

Classify spot, derivatives, and earn activity

Spot trades generate realized P&L entries; derivatives (perps, options) are classified by contract type with settlement P&L; OKX Earn (staking, savings) accruals are booked as yield income per period.

Common configurations

Asian crypto fund using OKX as primary exchange

The fund trades spot and perpetual derivatives on OKX and holds a portion in the OKX Web3 Wallet for DeFi activity on OKX Chain. Wag3s reconciles both surfaces, tagging internal transfers between them and producing a consolidated per-period P&L for the fund's accountant.

Web3 company with OKX as treasury management platform

The company uses OKX Earn for yield on idle USDT and USDC holdings. Wag3s ingests Earn accruals daily and books them as interest income, with the opening/closing balance tied to the on-chain position for the monthly treasury report.

Protocol using OKX exchange for token sales and buybacks

The protocol executes OTC token sales and market buybacks via OKX. Wag3s classifies each OTC trade as a treasury event, with the realized gain/loss and token-level cost basis update reflected in the next day's financial close.

OKX integration questions

Does Wag3s support OKX's perpetual futures and options?

Yes. Perpetual futures are classified by contract side (long/short) and settlement type (USDT-margined, coin-margined). Options are tracked with premium paid/received and expiry settlement. Unrealized P&L is tracked for open positions; realized P&L is booked on close or expiry.

Does the integration cover OKX Chain (X1)?

Yes. OKX Chain / X1 is one of the supported EVM chains. On-chain activity from the OKX Web3 Wallet on X1 is ingested and classified alongside activity on Ethereum, BNB Chain, and other supported networks.

How are OKX Earn rewards handled for accounting?

Flexible savings and staking rewards on OKX Earn are booked as interest or staking income on the accrual date. Fixed-term products are tracked from subscription to redemption, with the earned yield posted at the end of each term.

Connect OKX in minutes

Free during Alpha. No credit card. Native sync, audit trail, no spreadsheets.