Authentication

All API requests require a Bearer token

Authorization Header

Include your API key in the Authorization header of every request:

HTTP Header
Authorization: Bearer tdb_your_api_key

Example Request

curl
curl "https://api.tickerdb.com/v1/summary/AAPL" \ -H "Authorization: Bearer tdb_your_api_key"

API Keys

You can create unlimited API keys on any plan. TickerDB API keys always start with tdb_. This is useful for keeping production and development environments separate, or for running multiple projects under one account.

Error Responses

Missing or invalid tokens return 401 Unauthorized:

{ "error": "authentication_required", "message": "Missing Authorization header. Use: Authorization: Bearer <api_key>" }

Endpoints that require a higher tier return 403 Forbidden with an upgrade_url.