KoboTerminalNGX API DocsGet a free API key

Rate limits and errors

Errors are JSON with an error message, and upgrade or reset hints where relevant.

Error codes

StatusErrorWhat to do
401API key requiredNo key sent. Pass X-API-Key or ?api_key=. Get a free key instantly at https://koboterminal.com/api#get-key
401Invalid API keyThe key does not exist. Check for typos or copy it again from your email.
403API key is not active / has expiredThe key was revoked, expired, or a paid period ended. Renew at https://koboterminal.com/api
403Plan upgrade requiredThe endpoint needs a higher plan. The body includes current_plan, required plan and upgrade_url.
429Daily limit exceededYou used today's allowance. Resets at midnight WAT (reset_at in the body). The body names the next plan.
400Bad requestA parameter is malformed, e.g. a date not in YYYY-MM-DD.
404Not foundUnknown symbol, index or ETF.
5xxUpstream or server errorRetry with backoff. Data is cached, so retries are cheap.

Example: daily limit reached

json
{
  "error": "Daily limit exceeded",
  "limit": 100,
  "message": "You've used all 100 requests on the Free plan today...",
  "current_plan": "Free",
  "upgrade_url": "https://koboterminal.com/api",
  "next_plan": "starter",
  "reset_at": "2026-11-18T23:00:00.000Z"
}

Rate limits

PlanPrice (NGN)Price (USD)Requests / dayRequests / minBest for
FreeFreeFree10010Learning, prototypes, personal dashboards
Starter₦29,000/mo$20/mo1,00020Solo builders and small apps
Professional₦75,000/mo$50/mo10,00060Production apps, fintechs, client work
Institutional₦350,000/mo$200/mo50,000120Brokers, asset managers, trading terminals

Good practice