# Vintl

> Point-in-time macro-economic and treasury data API.

## Docs

- [Auth test](https://docs.vintl.io/api-reference/auth/auth-test.md): Validates API key and returns plan info, limits, and feature access
- [Liveness probe](https://docs.vintl.io/api-reference/health/liveness-probe.md)
- [Readiness probe](https://docs.vintl.io/api-reference/health/readiness-probe.md): Checks Postgres and Redis connectivity
- [Detect insider buying clusters](https://docs.vintl.io/api-reference/insider/detect-insider-buying-clusters.md): Auto-detects when multiple C-suite executives or directors are buying the same stock within a rolling time window. Only counts open-market purchases (transaction_code='P') by officers or directors. Default: 3+ insiders within 14 days.
- [List insider transaction filings](https://docs.vintl.io/api-reference/insider/list-insider-transaction-filings.md): Returns SEC Form 4 insider transaction filings. Filter by ticker, insider name, or time window. Defaults to last 30 days if no time filter specified.
- [Get observations for a series](https://docs.vintl.io/api-reference/macro/get-observations-for-a-series.md): Returns the latest values by default. Add `?as_of=DATE` for point-in-time queries — the killer feature that returns what was known at any historical date.
- [Revision history for one observation](https://docs.vintl.io/api-reference/macro/revision-history-for-one-observation.md): Returns all vintages (revisions) of a single observation date, ordered by publication date ascending. Shows how an economic data point was revised over time from initial release through annual revisions.
- [Search and list available series](https://docs.vintl.io/api-reference/series/search-and-list-available-series.md): Returns all available economic indicator series. Filter by ID pattern with the `q` parameter.
- [Series metadata](https://docs.vintl.io/api-reference/series/series-metadata.md): Returns metadata for a single economic indicator series.
- [Full yield curve for a date](https://docs.vintl.io/api-reference/treasury/full-yield-curve-for-a-date.md): Returns all maturities for a single date. Defaults to today if no date specified.
- [List treasury yield rates](https://docs.vintl.io/api-reference/treasury/list-treasury-yield-rates.md): Returns yield rates filtered by maturity, curve type, and date range. Paginated.
- [Yield spread over time](https://docs.vintl.io/api-reference/treasury/yield-spread-over-time.md): Returns the spread between two maturities (default 10Y-2Y) with basis points calculated.
- [Changelog](https://docs.vintl.io/changelog.md): Release notes for the Vintl API.
- [Authentication](https://docs.vintl.io/essentials/authentication.md): Authenticate with the Vintl API using an API key in the X-API-Key header.
- [Errors](https://docs.vintl.io/essentials/errors.md): Vintl API errors follow RFC 9457 Problem Details with application/problem+json content type.
- [Pagination](https://docs.vintl.io/essentials/pagination.md): Vintl API uses cursor-based pagination with has_more and next_cursor fields.
- [Rate Limits](https://docs.vintl.io/essentials/rate-limits.md): Vintl API rate limits by plan, response headers, and how to handle 429 errors.
- [AI Agents and Function Calling](https://docs.vintl.io/guides/ai-agents.md): Use the Vintl API as a tool for LLM agents, MCP servers, and function calling.
- [Point-in-Time Queries](https://docs.vintl.io/guides/point-in-time.md): Query what economic data was known at any historical date with the as_of parameter.
- [Python Quickstart](https://docs.vintl.io/guides/python-quickstart.md): Use Python to query macro-economic data, treasury yields, and point-in-time observations from the Vintl API.
- [Understanding Data Revisions](https://docs.vintl.io/guides/revisions.md): Economic data gets revised after publication. Track every revision with the Vintl API.
- [Treasury Yield Curve](https://docs.vintl.io/guides/yield-curve.md): Query daily treasury yield rates, build yield curves, and track the 10Y-2Y spread with the Vintl API.
- [Vintl API](https://docs.vintl.io/index.md): Point-in-time macro-economic and treasury data API. One query parameter to see what the data said then, not what it says today.
- [Quickstart](https://docs.vintl.io/quickstart.md): Make your first Vintl API call in under 2 minutes. Get real economic data with one curl command.

## OpenAPI Specs

- [v1](https://docs.vintl.io/openapi/v1.yaml)
- [openapi](https://docs.vintl.io/api-reference/openapi.json)