How to get API access
The free guest account is open to anyone and returns daily (end-of-day) data for US stocks and ETFs, plus a few free samples. A paid Premium subscription unlocks the full surface, including tick, intraday, NinjaTrader, and bid/ask formats. The other subscription tiers include the API for daily data only, and a new customer's first order without Premium includes 45 days of full API access to the purchased data, enabled automatically. This article covers each tier, what the entitlement grants, and the most common access questions.
Guest account
The guest account is anonymous and unrestricted by registration. Use the literal guest for both username and password:
https://api.kibot.com/?action=login&user=guest&password=guest
The guest account returns daily (end-of-day) data for any US stock or ETF. It also returns a small set of free samples: minute data (1-minute and coarser) for IBM, OIH, IVE, and WDC, and tick and bid/ask data for IVE and WDC. Every other request is refused: an intraday request for any other stock or ETF returns 400 Invalid Interval, and futures, forex, and indexes return 402. Adjustments are refused for guest with 400 Bad Request. As with every API error, these codes arrive in the response body of an HTTP 200 response, not as the HTTP status.
The standard 20-minute idle timeout applies to guest sessions just like paid ones. See API authentication for the session-lifecycle detail.
Premium subscription
Premium is the only subscription tier that includes the full API surface. Other tiers (Professional, Standard, Basic, EOD) include the API for daily (end-of-day) data only. The guest account is similar but limited to US stocks and ETFs. The pricing breakdown and the per-tier API matrix live in Data updates.
Premium includes 4 years of 1-minute and coarser history for all stocks, ETFs, futures, and forex, plus daily updates. Tick and aggregate bid/ask data are separate purchases: a Premium subscriber calling ?action=history&symbol=...&interval=tickbidask for a symbol without a tick purchase gets back 402 Unauthorized. '<email>' account is not authorized for <SYMBOL>. To see the per-symbol surface an account has, call login and read the Authorizations list it returns. The list of packages reflects the data purchases.
Upgrading an existing account
If an account is already on a non-API subscription (Professional, Standard, Basic, EOD), upgrading to Premium is an account-level change handled by support: the existing subscription is canceled and the Premium one starts on the new monthly billing cycle. Credentials carry over; no new password is issued.
45 days of API access with a first purchase
A new customer's first order without Premium includes 45 days of full API access on top of the file download. The access covers:
- The exact symbol list that was purchased, at the intervals included in the purchase.
- End-of-day data for all US stocks and ETFs.
- Anything on the Buy Data page that's marked as free.
Access is enabled automatically when the order completes. The same credentials used for FTP and order management work for API access.
When data becomes available
The API serves the same dataset Kibot publishes through FTP, direct download, and the Kibot Agent, so the availability windows are identical:
- US stocks and ETFs: minute and daily data are delayed 30 minutes during the regular session and become immediately available after the close. There is no real-time feed via API.
- Forex and futures: previous session data is available after 2:15 AM ET; some types refresh several times per day, with the last refresh around 6 PM ET.
- Adjustments list: the list of symbols that were back-adjusted overnight is available after 1 AM ET; the adjusted files themselves are ready after 4:45 AM ET. Check once a day after 1 AM ET, setting
startdateto the date of your last download, for example?action=adjustments&symbol=MSFT&startdate=03/30/2026, and re-download the file if any row comes back. See Adjustments request for the incremental flow.
Common access issues
"Works once, fails later"
This is almost always the 20-minute idle session timeout. The fix is to catch 401 Not Logged In, re-login, and retry. Detail and the alternative stateless pattern (credentials on every URL) are in API authentication.
"Your account does not have full access to API"
Three common causes:
- The account is on a non-Premium subscription tier and is calling a tick or intraday endpoint that requires Premium.
- The 45-day API access period has ended and the account never upgraded to a paid subscription.
- An auto-renew failed and the subscription quietly expired. The error message also appears as
497 Not Allowedin some response paths.
The fastest diagnostic is to log in and inspect the Authorizations list against the symbol being requested. If the symbol isn't covered by any listed package, the account is not entitled to that data.
"<email> account is not authorized for <SYMBOL>"
This is the 402 case: the account is logged in, but the symbol isn't in any owned package. It is common with futures (forgetting &type=futures), indexes (use $VIX not VIX, with &type=indexes), and symbols delisted before the account's first purchase date.
Rate limits and concurrency
We recommend at most 5 concurrent connections per account, shared across the API, FTP, and the Kibot Agent. This is a recommendation, not a hard limit. The hard ceilings are 40 in flight and 50 new requests per 500 ms per server; above those the rate limiter trips and the server starts returning 403 Login Failed for further requests, which is the same code the API uses for bad credentials. See API authentication for the disambiguation pattern and Data updates for the full per-server ceilings.
Concurrent connections are shared across API, FTP, and the Kibot Agent. A scheduled Agent job pulling daily updates and a Python script running tick downloads in parallel against the same account consume the same pool.
Key Takeaways
- The guest account is free: use
user=guest&password=guest. It returns daily data for US stocks and ETFs, plus the free intraday and tick samples. - Premium is the only subscription tier with full API access; other tiers include the API for daily data only.
- A new customer's first order without Premium includes 45 days of full API access covering the purchased symbols plus daily stocks/ETFs and free data, enabled automatically.
- Per-symbol entitlement is enforced by the
historyendpoint at request time, independently of the subscription tier; check theAuthorizationslist returned byloginto see what the account owns. - 5 concurrent connections per account is the recommended ceiling (a recommendation, not a hard limit); the connection pool is shared across API, FTP, and the Kibot Agent.
- "Your account does not have full access to API" almost always means subscription tier, the 45-day period ending, or auto-renew failure, not a per-symbol problem.
Related
- API overview: What the API is, every endpoint, and how the v2 changes affected access.
- API authentication: Login flow, session timeout, and the stateless credentials-on-URL pattern.
- Server responses: Full response code reference, including the 402 / 403 / 497 access-related codes.
- Rate limits and throttling: The 5-connection guideline, hard ceilings, and the backoff pattern for batch downloads.
- Data updates: Subscription tier matrix and per-server rate limits.
- Buy Data: Premium subscription and individual data packages.