Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaFinanceAvailable now

Coinbase Exchange · Get candles

api-exchange-coinbase-com/markets/get_candles

Get market and financial data with Coinbase Exchange · Get candles from Alexandria through one Spiral API key. Backtests and price history, e.g. 1-minute BTC-USD candles between two dates: call with granularity: 60, start, end, max_candles: 3000, then follow next_start until it is null. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
product_id requiredtext—

Trading pair id BASE-QUOTE as listed by list_products, e.g. BTC-USD, USELESS-USD. Case-insensitive; the canonical upper-case id is returned. Pattern: ^[A-Za-z0-9]{1,20}-[A-Za-z0-9]{1,20}$.

endtext—

Inclusive range end, same forms as start. Defaults to now.

starttext—

Inclusive range start: RFC 3339 (2026-07-24T00:00:00Z) or a date (2026-07-24, midnight UTC). Defaults to end minus max_candles buckets.

granularityone of
60, 300, 900, 3600, 21600, 86400
60

Bucket length in seconds: 60, 300, 900, 3600, 21600 or 86400.

max_candlesnumber
1 to 3000
300

Upper bound on buckets fetched in this call (300 per upstream request; requests are made sequentially to respect the 10 req/s public limit).

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "api-exchange-coinbase-com/markets/get_candles",
    "input": {
      "product_id": "<product_id>"
    }
  }'

Frequently asked questions

How much does Coinbase Exchange · Get candles cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Coinbase Exchange · Get candles through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "api-exchange-coinbase-com/markets/get_candles"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Coinbase Exchange · Get candles?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Coinbase Exchange · Get candles?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.