API & MCP
Connection troubleshooting
Identify the actual access or limit problem and choose the right recovery step.
Read the returned error
- invalid_cursor
This page cursor has expired. Call again without a cursor.
- invalid_request
This request could not be accepted. Check the market and fields.
- access_denied
This connection has no access. Check the account, plan and connection permissions.
- market_not_selected
Choose your market in Kunkafa first.
- market_not_authorized
This connection cannot read this market.
- traffic_limit
Kunkafa is receiving too many requests. Retry at the stated time; your allowance is not used up.
- rate_limit
Request limit reached. Retry at the stated time.
- concurrent_request
Another connection is using this account, or this one has as many requests running as its plan allows. Retry at the stated time.
- disclosure_limit
The allowance for new market summaries is used up. Retry at the stated time; see get_usage.
- session_replaced
Another API or MCP connection took over this account. Retry shortly, or manage connections in Account.
- service_unavailable
Kunkafa cannot check access or usage right now. Your allowance is not used up.
- data_unavailable
The data could not be loaded. Try again.
- response_too_large
This reply is too large. Ask for fewer durations, one direction, or a filter. Nothing was charged.
- data_delayed
The data is delayed; the market may be closed. Try again later.
- following_not_allowed
This connection cannot follow or unfollow markets. To allow it, reconnect Kunkafa in your AI app and approve "Follow and unfollow markets"; the connection is replaced, not added.
- market_not_found
Kunkafa has no market with this name. See list_markets.
- market_unavailable
This market has no live data right now. Choose another.
- follow_count_reached
This account follows as many markets as its plan allows. Unfollow one first.
- follow_replacement_confirmation
This replaces a followed market, allowed once every 30 days. Ask the user, then call again with confirmReplacement true.
- follow_replacement_window
A followed market can be replaced once every 30 days; next at the stated time.
- invalid_duration
Choose durations this market has now: 5 minutes, 1 hour, ….
- request_too_broad
This matches N forecasts in N durations; one call returns at most 72 in 6. Narrow by durations, direction or minProbabilityPercent.
Recover without losing track of usage
When a connection is revoked or expires, reconnect from your AI app (an app you approved before reconnects without a second screen) or create a new token in Account. Do not repeatedly reuse a rejected credential. A service failure is not proof that your quota is exhausted.
When no Free market is selected, open the app and choose one using its existing market controls. Market changes follow the account’s normal restrictions. A new connection does not create a new allowance.
Requests from one connection can run at the same time, up to your plan's burst. If a request is refused because another connection is using the account, or this connection already has that many running, retry at the time given, or revoke the unwanted connection in Account. App tabs keep working independently. Reloading, reconnecting or changing language does not reset limits.
For support, include the error code, time, platform and action you attempted. Never send passwords, sign-in codes, tokens or private prediction contents.