Authentication
All API requests require an API key. Include your key in the X-API-Key header with every request.
Getting your API key
- Create an account (free, no credit card required)
- Verify your email
- Go to your Dashboard and navigate to API Keys
- Click Create New Key and give it a name
- Copy the key immediately — it won’t be shown again
Using your API key
Include the key in the X-API-Key header:
curl -H "X-API-Key: nb_your_api_key_here" \
"https://api.polyhistorical.com/v1/markets?coin=BTC&limit=5"
API key limits by plan
| Plan | Max API Keys |
|---|
| Starter (Free) | 1 |
| Pro | 3 |
| Enterprise | 33 |
Security best practices
Never expose your API key in client-side code, public repositories, or browser requests. Always call the API from your backend server.
- Store keys in environment variables, not in code
- Use different keys for development and production
- Rotate keys periodically
- Revoke unused keys from your dashboard
