Skip to main content
GET
cURL
Get the state of one export job. Use it after Submit Trader Export and before you download the file.

Read the state

  • job_id is required. It comes from the submit response.
  • status is queued, running, ready, or failed. processed_trades and total_trades show progress.
  • file_size is set when the file is ready. error is set when the job failed.
  • The job is scoped to your account and to the trader in the path. A job_id under another trader or another account returns 404.
  • address accepts a 0x... wallet address, a username, or a trd_-prefixed trader ID. A trd_ id finds a job submitted under the wallet.

Poll the job

  1. Wait between reads. Each read counts against the request limit.
  2. Stop on ready or failed.
  3. On failed, read error, then submit a new job.
  4. Do not call the download route while the job is queued or running. It returns 400.
Download Trader Export redirects to the file once status is ready.

Authorizations

Authorization
string
header
required

API key authentication. Send your key in the Authorization header as Bearer oxi_sk_live_.... Live keys require an active Pro subscription and return live data.

Path Parameters

address
string
required

Trader wallet address (0x...), known trader username-style lookup, or trd_-prefixed trader ID emitted by this API.

Query Parameters

job_id
integer<int64>
required

Export job id returned by the submit route.

Response

Export job state

object
string
required
Allowed value: "trader_export_job"
data
object
required
meta
object
required