Rate Limits

How many requests you can make per day.

Each plan has a daily request limit. Limits reset at 00:00 UTC.

Plan	Daily limit
Free	100
Daily	1,000
Monthly	50,000
Unlimited	500,000

Checking your usage

curl https://api.polydata.live/v1/me \
  -H "Authorization: Bearer pd_live_xxxxx"

Response includes:

{
  "data": {
    "plan": "monthly",
    "rate_limit_daily": 50000,
    "requests_today": 1247
  }
}

When you exceed the limit

You’ll get a 429 Too Many Requests:

{
  "detail": {
    "error": "rate_limit_exceeded",
    "message": "Daily request limit (1000) exceeded.",
    "limit": 1000,
    "plan": "daily"
  }
}

Your access automatically resumes at UTC midnight, or you can upgrade your plan immediately.

Best practices

Use bulk endpoints

Instead of querying individual ticks one by one, use:

• /v1/ticks with a wide time range — single request returns up to 100,000 ticks
• /v1/ticks/export — streaming download of any size

Cache responses locally

Historical data doesn’t change. Cache responses in your application (e.g., Redis, SQLite, or just a JSON file).

Use OHLCV instead of raw ticks for charting

If you only need price candles, query /v1/ohlcv directly instead of computing them from ticks. Pre-aggregated, lower bandwidth.

Batch your queries

Don’t poll. Run all queries you need in a single batch at the start of your script.

Need higher limits?

For limits beyond Unlimited (500,000/day), contact us at [e-mail] for enterprise pricing.