API Key
API keys are used to call the SDK and APIs. Store them securely and never expose them publicly.
1. What is an API key?
An API key is your credential for accessing Timecho forecasting services. Each account has one API key by default. With an API key, you can associate requests with your account and review usage history.
Tip: By default, the key is partially masked (e.g.,
ts-uLeB***8BMw). Click the eye icon to reveal it, or click the copy button to copy the full key.
2. View and copy your API key
After signing in, open Account Center or the API key page to view your key details.
2.1 View the full API key
- Open the API key page and locate the API key display area.
- Click the eye icon to toggle showing/hiding the full key value.
- Save the full key for later API/SDK calls.
2.2 Copy the API key
- Click the copy icon (or copy button). The system will copy the full key to your clipboard.
- Paste it into your config or code to use it.
Security note: Keep your API key secure. Do not share it or commit it to public code repositories. If you suspect the key is exposed, contact support immediately.
3. Quota and usage
API calls are quota-controlled. The “Quota & Usage” area shows your current usage:
| Metric | Description |
|---|---|
| Used today | Number of forecast requests consumed today. Starts at 0. |
| Daily quota | Daily limit of forecast requests. Default is 100. |
Click the refresh button on the right to fetch the latest usage data.
4. Quota calculation rules
Please note the following rules when using the API:
- Each forecast consumes 1 quota unit, regardless of horizon length or data size.
- Daily quota resets automatically at 00:00. Unused quota does not roll over.
- Requests made via the Web UI and via SDK are both counted and aggregated.
Recommendation: If 100 requests per day is not sufficient, contact the Timecho team to request a higher quota.
5. FAQ
Q: How do I check quota usage?
When quota is exhausted, requests will return an “insufficient quota” error. Quota resets at 00:00 the next day, or contact the team for temporary quota.
Q: Can I use multiple API keys at the same time?
Currently, each account supports only one API key. For key management, contact support for enterprise options.
Q: What if my API key is exposed?
Contact support immediately to reset your key. The old key will be disabled right away.