Skip to main content
GET
cURL
Download a finished export. The API redirects to a short-lived presigned URL. Use it after Get Trader Export Status returns ready.

Read the redirect

  • job_id is required. The response is 302 with Location set to the presigned URL.
  • The presigned URL is valid for one hour. Do not store it.
  • The file is gzip-compressed with Content-Encoding: gzip and the format’s Content-Type: application/json, application/x-ndjson, or text/csv.
  • Content-Disposition names the file <address>-dataset.<extension>.

Fetch the file

  1. Poll the status route until status is ready. A download before ready returns 400 with param: "job_id".
  2. Send the request with curl -L --compressed. -L follows the redirect; --compressed inflates the gzip body.
  3. Without --compressed, curl -L -o file writes raw gzip bytes. Run gunzip on that file.
  4. A job_id under another trader or another account returns 404.
  5. When the presigned URL expires, request this route again for a new one.
Submit Trader Export starts the job and documents the three formats.

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

Redirect to the presigned download URL.