How to Check Trading History on OKX?

Accessing Trading History via OKX Web Interface

1. Log in to your OKX account using verified credentials and two-factor authentication.

2. Navigate to the top-right corner and click on the user profile icon to open the dropdown menu.

3. Select Trade History from the list of account options.

4. Choose between spot, margin, futures, or options tabs depending on the product type you traded.

5. Apply filters such as date range, instrument ID, order status, and trade direction to narrow results.

Retrieving Trade Records Through OKX API

1. Ensure your API key has 'Read-only' or 'Trade' permission enabled under API management settings.

2. Use the /api/v5/account/bills endpoint to fetch all transaction records including deposits, withdrawals, and transfers.

3. For executed trades specifically, call /api/v5/trade/fills with required parameters like instId, ordId, and limit.

4. Include proper authentication headers: OK-ACCESS-KEY, OK-ACCESS-SIGN, OK-ACCESS-TIMESTAMP, and OK-ACCESS-PASSPHRASE.

5. Handle pagination by checking the hasNext field in responses and repeating requests with updated before/after timestamps.

Exporting Historical Trade Data for Analysis

1. Within the OKX web interface, locate the Export button at the bottom of the Trade History table.

2. Select CSV format and define a custom time window—maximum supported duration is 90 days per export.

3. Download files directly or configure email delivery for large datasets exceeding browser limits.

4. For longer-term analysis, combine multiple exports manually or use python-okx library’s get_fills_history method.

5. Validate data integrity by cross-checking timestamps, fill prices, and fee amounts against on-chain settlement confirmations.

Common Issues When Retrieving Trade Records

1. Empty results may appear if the selected time range exceeds retention policy—OKX retains trade history for up to 180 days on standard accounts.

2. Missing fills could indicate failed order matching or partial execution not yet settled in the system ledger.

3. Discrepancies between displayed profit/loss and exported values often stem from rounding differences in fee calculation logic.

4. API rate limiting triggers HTTP 429 errors when exceeding 20 requests per second; implement exponential backoff strategies.

5. Legacy orders placed before March 2021 might not be accessible through current endpoints due to platform migration archives.

Frequently Asked Questions

Q1: Can I retrieve trade history older than six months?Yes, only through the /api/v5/trade/fills-history endpoint, which supports queries dating back to account creation, provided the API key has appropriate permissions.

Q2: Why do some trades show zero fees in the export file?This occurs when trading fee discounts apply, such as those granted via OKB holdings or VIP tier benefits—the actual fee amount is calculated but displayed as zero in simplified views.

Q3: Is there a way to filter trades by specific wallet address used for funding?No native filtering exists by funding address; however, users can match deposit IDs from /api/v5/asset/deposit-history with trade timestamps to infer source wallets.

Q4: Does OKX provide trade history in JSON format via web interface?No, the web UI only supports CSV export; JSON output requires direct API calls or third-party tools integrating with OKX’s RESTful endpoints.