Trade history

Buy an export

CHARGES THE BALANCE the order price; grants the entities' daily wallet files over [from, to] (30+ days, max 25 entities). maxPriceCents caps it (required for 2+). Same order within 24 h returns the existing one, no charge. 1 distinct-entity unit per entity. viaPlan: from the plan, free.

POST/v1/account/exportsAPI keySpends balance

Request body

entityIdsstring[]

Entity handles, or 0x addresses — all the same form.

fromstring

First UTC day, inclusive.

tostring

Last UTC day, inclusive.

maxPriceCentsinteger

Ceiling in cents (quote orderPriceCents). Required for 2+ entities.

Allowed range: 0 <= x

viaPlanboolean

Use the plan export allowance (whole window, no charge).

Response

idstring

priceCentsinteger

daysinteger

rowsinteger

fromstring

tostring

statusstring

viaPlanboolean

Responses

201Paid (or granted) and ready (HTTP 201).

400Bad body, mixed handle/address naming, or error: not_sellable (below 30 days / no data).

401No valid API key (missing, malformed, unknown or revoked).

402error: insufficient_balance (priceCents, balanceCents) or error: no_plan for viaPlan. Nothing charged.

403error: entity_budget: daily distinct-entity limit reached.

409error: price_changed with the new quote, or error: plan_exhausted (cap, used, needed). Nothing charged.

503Temporarily unavailable; nothing was charged. Retry shortly.