API Reference

Quick reference for all Vintl API endpoints.

Base URL

Authentication

Include your key in the X-API-Key header.

curl -H "X-API-Key: mda_live_sk_..." \
 https://api.vintl.io/v1/ping

Response format

All responses follow a consistent envelope. Decimals are strings — no float drift.

{
  "object": "...",
  "request_id": "req_...",
  "results": [...],
  "has_more": false
}

Status codes

200OK

400Bad Request

401Unauthorized — missing or invalid API key

403Plan upgrade required (e.g. ?as_of on Free)

429Rate limit exceeded — check Retry-After header

Cmd+K

Auth1

Need more detail?

Full guides, SDKs, and webhook documentation on our docs site.