Docs/Subscriptions/Fetch history on demand

Fetch history on demand

POST/v1/history/fetch🔑 API key required

Kick off a bounded historical backfill for a mint WITHOUT subscribing a slot — the fastest way to evaluate a token. Returns immediately with a status URL; poll GET /v1/token/:mint/backfill (and /ohlcv) as the data fills in.

Body

Field	Type	Description
`mint`required	string	The token mint (base58).
`network`optional	mainnet \| devnet	Default mainnet. Devnet has no archive (400).
`hours`optional	number	Lookback window to walk (default 72h; capped server-side).

Response fields

Field	Type	Description
`enqueued`	boolean	True when a backfill was queued; false when already indexed (see reason).
`reason`	string	When enqueued=false: already_indexed \| invalid / why nothing was queued.
`statusUrl`	string	Poll this (GET /v1/token/:mint/backfill) for progress.

No mint slot is consumed. The first GET /v1/token/:mint/ohlcv on an unindexed mint triggers the same bounded fetch automatically. Drained by the gTFA queue worker (recent slots) — much faster than the archive path.

← PreviousBackfill progress Next →Account

curl -X POST "https://www.quanaris.com/v1/history/fetch" \ -H "x-api-key: $QUANARIS_KEY" \ -H "content-type: application/json" \ -d '{ "mint": "C7heQqfNzdMbUFQwcHkL9FvdwsFsDRBnfwZDDyWYCLTZ", "network": "mainnet", "hours": "mainnet" }'

const res = await fetch("https://www.quanaris.com/v1/history/fetch", { method: "POST", headers: { "x-api-key": process.env.QUANARIS_KEY, "content-type": "application/json" }, body: JSON.stringify({ mint: "C7heQqfNzdMbUFQwcHkL9FvdwsFsDRBnfwZDDyWYCLTZ", network: "mainnet", hours: "mainnet" }) }); const data = await res.json();