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

AlexandriaFinanceAvailable now

AWS Price List Bulk API · Records list

pricing-us-east-1-amazonaws-com/cloud-pricing/records_list

Get market and financial data with AWS Price List Bulk API · Records list from Alexandria through one Spiral API key. To collect every price row of an offer in one region for one version, page by page, from the first call (no continuation) until meta.page.continuation is exhausted. 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
region requiredtext—

AWS region code as a path segment of the region index, e.g. us-east-1, eu-west-1, us-east-1-bog-1 (Local Zone) or ap-northeast-1-wl1-nrt1 (Wavelength). Pattern: ^[a-z]{2}(-[a-z0-9]+){2,5}$.

version requiredtext—

Publication version id (YYYYMMDDHHMMSS, from versions_list) or current, which is resolved to the current version id through the region index so every file URL stays versioned. Pattern: ^([0-9]{14}|current)$.

offer_codetext—

Offer code from offers_list, e.g. AmazonEC2, AmazonRDS, AmazonS3 (the offerCode key of the offer index and the serviceCode CSV column). Pattern: ^[A-Za-z0-9]{2,64}$.

continuationtext—

Opaque cursor from the previous page (meta.page.next_cursor); carries the pinned file URL, ETag, size, byte offset and header.

window_bytesnumber
4096 to 8388608
4194304

Bytes requested per page with Range. A 4 MiB window of the EC2 file (about 5,400 rows) returned in roughly 1 s and 8 MiB (about 10,900 rows) in 2 s through the ISP proxy; 16 MiB exceeded the 256 MB guest memory, so 8 MiB is the ceiling. The first window must hold the 5 metadata lines and the header.

savings_plan_offertext—

Savings plan offer family from offers_list savings_plan_offer: AWSComputeSavingsPlan, AWSDatabaseSavingsPlans or AWSMachineLearningSavingsPlans. Pattern: ^[A-Za-z0-9]{2,64}$.

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": "pricing-us-east-1-amazonaws-com/cloud-pricing/records_list",
    "input": {
      "region": "<region>",
      "version": "<version>",
      "offer_code": "<offer_code>"
    }
  }'

Frequently asked questions

How much does AWS Price List Bulk API · Records list 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 AWS Price List Bulk API · Records list through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "pricing-us-east-1-amazonaws-com/cloud-pricing/records_list"` 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 AWS Price List Bulk API · Records list?

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

Can my AI agent use AWS Price List Bulk API · Records list?

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