Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vintl.io/llms.txt

Use this file to discover all available pages before exploring further.

Every macro data API gives you what the data says today. Vintl gives you what the data said then.

Quickstart

First API call in under 2 minutes. Free tier, no credit card.

Point-in-time queries

One parameter to query what the data said on any historical date.

API Reference

Interactive playground for every endpoint.

​
The problem

GDP published on October 26, 2023: $22,491B. That same quarter revised by September 2025: $22,841B. A $349 billion gap. If your backtest uses today’s numbers, it’s using information that didn’t exist when the trade would have been placed. 
# Add ?as_of= to any macro query. That's all it takes.
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.vintl.io/v1/series/GDPC1/observations?as_of=2023-10-26"
Returns "22491.567" — the advance estimate published that day, not today’s revision.

​
Data coverage

Treasury yields

Daily par and TIPS curves. 14 maturities, 1990-present. Spreads in basis points. Never revised.

Macro indicators

GDP, CPI, unemployment, payrolls, fed funds, industrial production, housing starts, PCE. Every revision tracked.

Point-in-time snapshots

?as_of=DATE on any macro series. Returns exactly what was published on that date.

Revision history

Full audit trail for every data point. See how GDP moved across 5 revisions over 2 years.

​
Design principles

Consistent object, request_id, status, results across every endpoint. Cursor pagination. RFC 9457 errors. If you’ve used Stripe’s API, this will feel familiar.

​
Start building

1

Get your API key

Sign up at app.vintl.io. Free tier: 500 requests/day, no credit card.
2

Make your first call

Follow the quickstart — real economic data in one curl command.
3

Explore point-in-time

Read the point-in-time guide to understand the as_of parameter.
Last modified on March 29, 2026