Overview.
The Spend Graph is read through one queryable surface: ask for a slice of American consumer spending and the record answers. The same surface backs Revere datasets, Spend Market resolution, and agent access over MCP and x402. Full endpoint reference ships with the developer platform; this page describes the surface so you can design against it today.
Query dimensions.
Every query is a combination of four dimensions:
- Merchant: a resolved merchant entity, public or private
- Category: the unified taxonomy, from top-level categories to detailed subcategories
- Geography: national down to regional resolution
- Time: daily grain, windows of your choosing
Point-in-time vintage.
Every record carries what was known and when it was known. Ask for a window as-of a date and the response contains only what was knowable then, with no lookahead and no silent revisions. Backtests and audits read the same record the live query does.
Response shape.
Responses are aggregates over cohorts large enough that no individual is identifiable: series of observations keyed by the dimensions you asked for. Illustrative sketch (not a live endpoint):
// illustrative: full reference ships with the developer platform
query: { merchant: "...", window: "28d", as_of: "2026-06-01" }
response: {
series: [{ date, observed_spend_index, txn_count_band }],
vintage: "2026-06-01T06:00:00Z",
coverage: { cards: "150M+", monthly_txns: "3.7B" }
}Access.
Institutional access is licensed today. Write to sales@americanspend.com and we will walk you through coverage, delivery, and terms. Agents access the same surface without a license over x402. See Agents.