> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cabalspy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Every error code of the CabalSpy ID Data API, White-Label, competitions, callouts, the Trade Feed, copy trading, the thesis browser API and the streams, what it means and how to fix it.

Every Data API error has the same shape. The `docs` field links to the matching section of this page.

```json theme={null}
{
  "success": false,
  "error": {
    "code": "wallet_not_found",
    "message": "This wallet is not verified by a CabalSpy ID user in your instance (or beyond your plan's user limit)",
    "request_id": "req_5162c7cf7f87",
    "docs": "https://docs.cabalspy.xyz/cabalspy-id/errors#wallet_not_found"
  }
}
```

Parameter errors add `parameter`, the parameter at fault, and where it helps `allowed`, the accepted values. Always quote the `request_id` when you contact support.

Errors of the OpenID Connect endpoints use the OAuth format instead, see [OAuth errors](https://docs.cabalspy.xyz/cabalspy-id/openid-connect.md#oauth-errors).

## Overview

| Status | Code | Meaning |
| - | - | - |
| 400 | [missing\_parameter](#missing_parameter) | A required parameter is missing. |
| 400 | [invalid\_parameter](#invalid_parameter) | A parameter has an invalid value. |
| 400 | [instance\_required](#instance_required) | Your account has several instances, pass instance. |
| 401 | [missing\_api\_key](#missing_api_key) | No API key was sent. |
| 403 | [invalid\_api\_key](#invalid_api_key) | The API key is invalid or does not exist. |
| 403 | [product\_not\_enabled](#product_not_enabled) | The key is not enabled for CabalSpy ID. |
| 403 | [no\_instance](#no_instance) | Your account has no CabalSpy ID instance yet. |
| 403 | [scope\_not\_allowed](#scope_not_allowed) | scope=global needs the Enterprise plan. |
| 403 | [plan\_user\_limit](#plan_user_limit) | The user signed in beyond your plan's user limit, or no room for a new platform user. |
| 404 | [instance\_not\_found](#instance_not_found) | No instance with this client\_id in your account. |
| 404 | [profile\_not\_found](#profile_not_found) | No such user in your instance. |
| 404 | [wallet\_not\_found](#wallet_not_found) | The wallet is not verified by one of your users, or the platform user has no such wallet. |
| 429 | [rate\_limit\_exceeded](#rate_limit_exceeded) | Too many requests per second. |
| 500 | [internal\_error](#internal_error) | Something went wrong on our side. |
| 503 | [service\_unavailable](#service_unavailable) | A data source is temporarily unavailable. |
| 400 | [invalid\_body](#invalid_body) | Thesis or reply text rejected, or an inbound event that is not JSON. |
| 400 | [duplicate](#duplicate) | The user already posted that text. |
| 401 | [sign\_in\_required](#sign_in_required) | Browser API: no user token sent. |
| 401 | [invalid\_token](#invalid_token) | Browser API: user token invalid or expired. |
| 403 | [scope\_missing](#scope_missing) | Browser API: the token lacks the scope thesis (or trade\_feed for the Trade Feed widgets). |
| 401 | [client\_id\_required](#client_id_required) | Browser API: no client\_id was sent. |
| 401 | [invalid\_client](#invalid_client) | Browser API: unknown, suspended or deleted instance. |
| 403 | [origin\_not\_allowed](#origin_not_allowed) | Browser API: the origin is not allowed for the instance. |
| 403 | [consent\_required](#consent_required) | The user has not granted your app the scope thesis, or trade\_feed for the Trade Feed and copy trading. |
| 403 | [sandbox\_user](#sandbox_user) | Sandbox test users cannot write theses. |
| 403 | [not\_a\_holder](#not_a_holder) | Only holders can post a thesis or, with require\_holding, make a callout. |
| 403 | [posting\_paused](#posting_paused) | The user is paused from writing. |
| 403 | [reporting\_paused](#reporting_paused) | The user cannot report for now. |
| 404 | [not\_found](#not_found) | The thesis or reply is not available, or no such copy instruction. |
| 429 | [rate\_limited](#rate_limited) | The user writes too fast, too many browser API requests per IP or client\_id, or too many new platform users or inbound events. |
| 400 | [wallet\_required](#wallet_required) | White-Label: a user needs at least one wallet. |
| 400 | [invalid\_address](#invalid_address) | White-Label: not a valid Solana or EVM address. |
| 400 | [invalid\_return\_url](#invalid_return_url) | White-Label: return\_url is not on your instance's sites. |
| 410 | [claim\_removed](#claim_removed) | White-Label: claim links are gone (one CabalSpy ID per person). |
| 404 | [platform\_user\_not\_found](#platform_user_not_found) | White-Label: no user with this external\_id. |
| 404 | [verification\_not\_found](#verification_not_found) | White-Label: no such wallet verification. |
| 404 | [invalid\_inbound\_url](#invalid_inbound_url) | White-Label: unknown or disabled inbound URL. |
| 409 | [self\_managed](#self_managed) | White-Label: the person manages their CabalSpy ID themselves. |
| 409 | [too\_many\_wallets](#too_many_wallets) | White-Label: more than 5 Solana or 5 EVM wallets. |
| 409 | [last\_wallet](#last_wallet) | White-Label: the user's only wallet cannot be removed. |
| 409 | [wallet\_already\_verified](#wallet_already_verified) | White-Label: another account verified this wallet. |
| 409 | [already\_verified](#already_verified) | White-Label: the wallet is already verified on this chain. |
| 429 | [too\_many\_open\_verifications](#too_many_open_verifications) | White-Label: too many open verifications. |
| 409 | [kol\_badge](#kol_badge) | White-Label: X cannot be disconnected from a KOL. |
| 409 | [x\_required](#x_required) | White-Label: the KOL badge needs X. |
| 409 | [kol\_not\_eligible](#kol_not_eligible) | White-Label: the KOL application was refused. |
| 409 | [volume\_check\_unavailable](#volume_check_unavailable) | White-Label: a volume check is not possible now. |
| 404 | [competition\_not\_found](#competition_not_found) | Competitions: no such competition. |
| 409 | [competition\_limit](#competition_limit) | Competitions: 5 are already open. |
| 409 | [competition\_closed](#competition_closed) | Competitions: it ended or was cancelled. |
| 409 | [late\_join\_closed](#late_join_closed) | Competitions: no joining after the start. |
| 409 | [competition\_full](#competition_full) | Competitions: max\_participants reached. |
| 403 | [feature\_not\_enabled](#feature_not_enabled) | Callouts: not switched on for your instance. |
| 403 | [invalid\_account](#invalid_account) | Callouts: the user's account is not active. |
| 403 | [kol\_only](#kol_only) | Callouts: only KOLs can call on your platform. |
| 409 | [already\_called](#already_called) | Callouts: the user called this token less than 24 hours ago. |
| 429 | [callout\_cooldown](#callout_cooldown) | Callouts: the user's cooldown is running. |
| 422 | [no\_price](#no_price) | Callouts: the token has no market price. |
| 404 | [callout\_not\_found](#callout_not_found) | Callouts: no such callout. |
| 400 | [cannot\_add\_self](#cannot_add_self) | Trade Feed: a user cannot add themselves. |
| 403 | [trading\_private](#trading_private) | Trade Feed: the trader keeps their trading private. |
| 404 | [trader\_not\_found](#trader_not_found) | Trade Feed: no such trader. |
| 409 | [trade\_feed\_full](#trade_feed_full) | Trade Feed: already 300 traders. |
| 404 | [not\_in\_trade\_feed](#not_in_trade_feed) | Copy trading: the trader is not in the user's Trade Feed. |
| 409 | [copy\_managed\_elsewhere](#copy_managed_elsewhere) | Copy trading: another platform copies this trader for the user. |
| 409 | [already\_reported](#already_reported) | Copy trading: the instruction already has a different final status. |
| stream | [plan\_required](#plan_required) | The stream needs the Pro plan or higher. |
| stream | [too\_many\_tokens](#too_many_tokens) | Theses stream: more than 200 tokens on one connection. |
| stream | [invalid\_frame](#invalid_frame) | Theses stream: a frame was not understood. |
| stream | [too\_many\_connections](#too_many_connections) | At most 5 stream connections per key. |

## Request errors

### missing\_parameter

**400.** A required parameter is missing. `parameter` names it. On [Profile](https://docs.cabalspy.xyz/cabalspy-id/profile.md) it means you did not pass exactly one of `username`, `csid_id` or `address`.

### invalid\_parameter

**400.** A parameter has an invalid value, for example an unknown `blockchain`, a `period` other than 6h, 1d, 7d or 30d, a `limit` out of range, an unknown `sort`, a malformed `cursor` or a `csid_id` that is not the `sub` of a CabalSpy ID token. `parameter` names it and `allowed` lists the accepted values where there is a fixed list. On the stream it means an invalid `blockchain`.

### instance\_required

**400.** Your account has several CabalSpy ID instances and the API cannot tell which one you mean. Add `instance=<client_id>` to the request. The message lists your instances.

## Authentication errors

### missing\_api\_key

**401.** No API key was sent. Pass it as `Authorization: Bearer <key>` or as the `apiKey` or `api_key` query parameter. See [Authentication](https://docs.cabalspy.xyz/cabalspy-id/data-api.md#authentication).

### invalid\_api\_key

**403.** The API key is invalid, revoked or does not exist. Copy the key again from the [API Dashboard](https://apidashboard.cabalspy.xyz). On the stream this code is also used when no key was sent.

### product\_not\_enabled

**403.** The key is valid for the CabalSpy API but not enabled for CabalSpy ID. Open the **API keys** page of the dashboard and switch on **CabalSpy ID** for the key.

### no\_instance

**403.** Your account has no CabalSpy ID instance yet. Create one in the dashboard on the **CabalSpy ID** tab.

### instance\_not\_found

**404.** The `instance` you passed is not an active CabalSpy ID instance of your account. Check the Instance ID (`csid_...`) in the dashboard.

## Access errors

### scope\_not\_allowed

**403.** `scope=global`, access to every CabalSpy ID user, is available on the Enterprise plan. Without it your key sees the users of your instance. Remove the parameter or contact sales.

### plan\_user\_limit

**403.** You passed an anonymous id (`anon_...`). The person signed in beyond your plan's user limit, so your platform receives no data for them until it upgrades. The error carries `"limited": true`. See [Plans and limits](https://docs.cabalspy.xyz/cabalspy-id/plans.md#the-user-limit).

White-Label: a new [platform user](https://docs.cabalspy.xyz/cabalspy-id/white-label.md#plan-limits) does not fit in your plan. All seats of your domain's plan are taken, or a sandbox or development instance already holds 25 platform users. The error carries `user_limit`, and on live instances `users` and `plan`. Existing users can still be updated. Starting a wallet verification for a user without a seat returns it too.

### profile\_not\_found

**404.** No CabalSpy ID user matches the username, csid\_id or address, or the user is not visible to your key: they never signed in to your instance, removed access, were blocked by you, or are beyond your plan's user limit.

### wallet\_not\_found

**404.** The wallet is not verified on this chain by one of your users. Check the `blockchain`: a wallet is only found on the chains it is verified on, listed in the user's `wallets[].chains`. As with profile\_not\_found, users outside your instance or beyond your plan's user limit are not visible.

White-Label: on [Remove a wallet](https://docs.cabalspy.xyz/cabalspy-id/platform-users-wallets.md#remove-a-wallet), the platform user has no wallet with this address.

## Limits

### rate\_limit\_exceeded

**429.** You sent more requests per second than your plan allows. The response carries `Retry-After: 1`, wait a second and retry. `X-RateLimit-Limit` shows your limit. See [Plans and limits](https://docs.cabalspy.xyz/cabalspy-id/plans.md#rate-limits).

## Server errors

### internal\_error

**500.** Something went wrong on our side. Retry with a backoff, and contact support with the `request_id` if it persists.

### service\_unavailable

**503.** A data source is temporarily unavailable, used by [Holdings](https://docs.cabalspy.xyz/cabalspy-id/holdings.md), and by [wallet verification](https://docs.cabalspy.xyz/cabalspy-id/platform-users-verification.md) and [Telegram linking](https://docs.cabalspy.xyz/cabalspy-id/platform-users-telegram.md) for platform users. Retry shortly.

## Thesis errors

These codes come from the [thesis](https://docs.cabalspy.xyz/cabalspy-id/theses.md) endpoints of the Data API and from the [browser API](https://docs.cabalspy.xyz/cabalspy-id/theses-browser-api.md). Their messages are written for end users, so you can show them as they are. `plan_user_limit` (above) also applies when a user beyond your plan's user limit tries to write.

### invalid\_body

**400.** The text was rejected: empty, longer than 1,000 characters, more than two links, written in all caps, repeated-character spam, or containing a blocked word. The message says which.

On the [inbound URL](https://docs.cabalspy.xyz/cabalspy-id/platform-users-inbound.md): the body is not JSON. A JSON body that is not an object is answered with 200 and `accepted: false` with this code.

### duplicate

**400.** The user posted exactly the same text within the last day.

### sign\_in\_required

**401.** Browser API only: no `Authorization: Bearer <token>` was sent. Let the user sign in with CabalSpy ID and pass their access token.

### invalid\_token

**401.** Browser API only: the user's token is invalid or expired, the user revoked access, or the account is not active. Access tokens live 15 minutes, refresh the token or let the user sign in again.

### scope\_missing

**403.** Browser API only: the access token does not carry the scope `thesis`. Request `thesis` at sign-in. The [Trade Feed widgets](https://docs.cabalspy.xyz/cabalspy-id/trade-feed-widgets.md) and their browser API need the scope `trade_feed` instead.

### client\_id\_required

**401.** Browser API only: the request carried no client\_id. Every call of `https://id.cabalspy.xyz/thesis/v1` needs your instance's public client\_id, as header `X-CSID-Client-Id: csid_...` or query `?client_id=csid_...`; the websocket takes `?client_id=`. For the widget set `data-client-id` on the `data-csid-thesis` element. The SDK's `ThesisClient` needs `clientId` (TypeScript) or `client_id` (Python) from version 0.5.2. The client\_id is shown in the [API Dashboard](https://apidashboard.cabalspy.xyz) under **CabalSpy ID**, **Instances** next to the API key. It is public, not the API key. On the websocket the connection closes with code 4401 and reason `client_id_required`. See [Client ID](https://docs.cabalspy.xyz/cabalspy-id/theses-browser-api.md#client-id).

### invalid\_client

**401.** Browser API only: the client\_id is not an active instance: it is unknown, suspended or deleted. Also returned when the header and the query parameter carry different client\_ids. Copy the Instance ID (`csid_...`) again from the dashboard. On the websocket the connection closes with code 4401 and reason `invalid_client`.

### origin\_not\_allowed

**403.** Browser API only: the request came from a page that is not one of your instance's sites. Allowed are the registered allowed origins, the origins of your redirect URIs and your verified domain including its subdomains (https), and, while the instance is not in live mode, `http://localhost:*` and `http://127.0.0.1:*`. Add the origin in the dashboard or verify the domain. Calls from a server without an `Origin` or `Referer` header only need a valid client\_id. The `/embed/thesis` iframe of the widget can likewise only be framed by these sites. On the websocket the connection closes with code 4403 and reason `origin_not_allowed`.

### consent\_required

**403.** Data API: the user has not signed in to your app with the scope `thesis`, revoked it, or is blocked by you. Ask the user to sign in again with the scope. [Eligibility](https://docs.cabalspy.xyz/cabalspy-id/theses-eligibility.md) returns this as `reason` instead of an error.

[Trade Feed](https://docs.cabalspy.xyz/cabalspy-id/trade-feed-api.md) and [copy trading](https://docs.cabalspy.xyz/cabalspy-id/copy-trading.md) endpoints answer with this code when the user has not signed in to your app with the scope `trade_feed`, revoked it, is blocked by you, or is beyond your plan's user limit. Request `trade_feed` at sign-in. Platform users always have the scope.

### sandbox\_user

**403.** Made-up sandbox test users cannot write theses.

### not\_a\_holder

**403.** Only holders can post a thesis: one of the user's verified wallets must have bought the token and still hold it. Replies, reactions and reports do not need this.

[Callouts](https://docs.cabalspy.xyz/cabalspy-id/callouts-create.md): with the setting `require_holding` (on by default), the user must hold the token in one of their wallets that count on its chain. Switch it off in the [callout settings](https://docs.cabalspy.xyz/cabalspy-id/callouts-settings.md) to let anyone call.

### posting\_paused

**403.** The user is paused from posting, replying and reacting, for example after several of their posts were hidden after reports. The message says until when.

### reporting\_paused

**403.** Moderators rejected too many of the user's reports, so they cannot report posts for 30 days. The message says until when. See [Moderation and appeals](https://docs.cabalspy.xyz/cabalspy-id/theses-moderation.md#reports).

### not\_found

**404.** For appeals: there is no such notification for this user, or it cannot be appealed. Otherwise: the thesis or reply does not exist, was hidden or deleted, or the user tried to delete someone else's post. Replies to a reply are also refused with this code.

[Copy trading](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-instructions.md): there is no copy instruction with this id for your instance. Instructions of users copied by another platform are not visible to you.

### rate\_limited

**429.** The user writes too fast: 5 theses per hour and 1 per token every 10 minutes, 30 replies per hour, 120 reactions per hour, 20 reports per day. On the browser API also too many requests from one IP address or for one client\_id: about 600 reads and 300 writes per minute per client\_id, 120 reads per minute per IP address, and the per-IP write limits of the [browser API](https://docs.cabalspy.xyz/cabalspy-id/theses-browser-api.md#responses). The response carries `Retry-After: 60`. On the websocket the connection closes with code 4429 and reason `rate_limited`. Different from rate\_limit\_exceeded, which is about your API key.

Trade Feed: more than 120 changes to one user's Trade Feed per hour, including [copy settings](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-settings.md) changes. Try again later.

White-Label: more than 2,000 new platform users per minute, more than 600 events per minute on the [inbound URL](https://docs.cabalspy.xyz/cabalspy-id/platform-users-inbound.md#rate-limit-and-retries), or wallet verifications started too fast. These answers carry a `Retry-After` header with the seconds until the next full minute.

## White-Label errors

These codes come from the [White-Label](https://docs.cabalspy.xyz/cabalspy-id/white-label.md) endpoints under `/v1/platform-users` and from other endpoints when you pass `external_id`.

### platform\_user\_not\_found

**404.** No platform user with this `external_id` (or `csid_id`) in your instance. Create it with [POST /v1/platform-users](https://docs.cabalspy.xyz/cabalspy-id/platform-users-create.md) first. Every endpoint that takes `external_id` in place of `csid_id` answers with this code too.

### wallet\_required

**400.** A new platform user needs at least one wallet. Pass `wallets: [{"address": "..."}]`. Also returned by Add wallets without wallets.

### invalid\_address

**400.** A wallet is not a valid Solana or EVM address, or, for a verification, the address does not match the chain. `wallets[i]` in the message names the item.

### too\_many\_wallets

**409.** The user would have more than 5 Solana or more than 5 EVM wallets. Remove one first.

### last\_wallet

**409.** Every platform user needs at least one wallet, so the last one cannot be removed. Add another wallet first, or [delete the user](https://docs.cabalspy.xyz/cabalspy-id/platform-users-delete.md).

### self\_managed

**409.** The person signs in to their CabalSpy ID themselves and manages profile, X and Telegram. You can still read their data, report wallets and [delete](https://docs.cabalspy.xyz/cabalspy-id/platform-users-delete.md) your link, but not change the account. Until 0.10.0 of the SDKs this code was `account_claimed`.

### already\_linked

Not an HTTP error. A person is your user only once: when one of your users proves an identity (X, Telegram or a paid wallet) of a CabalSpy ID that is already your user under another `external_id`, nothing is merged. What you see depends on the flow:

* **X:** the return URL gets `error=x_already_linked`.
* **Telegram:** the bot tells the person, and the Telegram stays unlinked.
* **Wallet verification:** the payment is not matched; the verification expires (`verification.expired`). Contact support if a user paid.

Remove one of the two users first.

### wallet\_already\_verified

**409.** Another account already verified this wallet with a payment. It cannot be verified again.

### already\_verified

**409.** The wallet is already verified on this chain.

### too\_many\_open\_verifications

**429.** Too many wallet verifications are open at once. Wait until one is paid or expires, or [cancel](https://docs.cabalspy.xyz/cabalspy-id/platform-users-verification.md#cancel) one.

### verification\_not\_found

**404.** No wallet verification with this id for your platform users.

### claim\_removed

**410.** Claim links are gone. Every person has one CabalSpy ID: your user moves to their own ID by itself when they prove it, see [One person, one CabalSpy ID](https://docs.cabalspy.xyz/cabalspy-id/white-label.md#one-person-one-cabalspy-id).

### invalid\_return\_url

**400.** `return_url` must be on one of your instance's verified domains (or a subdomain), registered origins or redirect URIs, over https, or on `http://localhost`.

### kol\_badge

**409.** The user has the KOL badge, which belongs to their X account, so X cannot be disconnected.

### x\_required

**409.** The KOL badge needs a connected X account. Connect it with [X connect](https://docs.cabalspy.xyz/cabalspy-id/platform-users-x.md) first.

### kol\_not\_eligible

**409.** The KOL application was refused. The message says why and `criteria` lists the badge criteria. See [KOL badge](https://docs.cabalspy.xyz/cabalspy-id/platform-users-kol.md).

### volume\_check\_unavailable

**409.** A volume check cannot be requested right now. The message says why; `volume_check_next_at` in the [KOL status](https://docs.cabalspy.xyz/cabalspy-id/platform-users-kol.md#status) says when the next one is possible.

### invalid\_inbound\_url

**404.** The [inbound URL](https://docs.cabalspy.xyz/cabalspy-id/platform-users-inbound.md) is unknown, was replaced by a newer one, or is disabled. Enable it again to get a new URL.

## Competition errors

These codes come from the [competition](https://docs.cabalspy.xyz/cabalspy-id/competitions.md) endpoints.

### competition\_not\_found

**404.** No competition with this id in your instance.

### competition\_limit

**409.** At most 5 competitions can be open at the same time (scheduled, waiting and running) per developer account, across all your instances. End or [cancel](https://docs.cabalspy.xyz/cabalspy-id/competitions-update.md#cancel) one first. The error carries `limit`.

### competition\_closed

**409.** The competition already ended or was cancelled. It can no longer be changed, joined or left.

### late\_join\_closed

**409.** The competition is running and `late_join` is false, so it takes no new participants.

### competition\_full

**409.** The competition reached `max_participants`.

## Callout errors

These codes come from the [callout](https://docs.cabalspy.xyz/cabalspy-id/callouts.md) endpoints and from creating or updating a [callout competition](https://docs.cabalspy.xyz/cabalspy-id/competitions-callouts.md). Their messages are written for end users, so you can show them as they are. Callouts also use [not\_a\_holder](#not_a_holder), [posting\_paused](#posting_paused), [consent\_required](#consent_required), [sandbox\_user](#sandbox_user), [plan\_user\_limit](#plan_user_limit), [platform\_user\_not\_found](#platform_user_not_found) and [service\_unavailable](#service_unavailable) (the price could not be read).

### feature\_not\_enabled

**403.** Callouts are switched on per instance on request, and they are not on for yours. Every callout endpoint, the callouts stream, creating a competition with `"kind": "callouts"` and updating an existing callout competition answer with this code. Contact us at [contact@cabalspy.xyz](mailto:contact@cabalspy.xyz) to enable them. [GET /v1/me](https://docs.cabalspy.xyz/cabalspy-id/me.md) lists `"callouts"` in `features` once they are on.

### invalid\_account

**403.** The user's account is not active, so they cannot make callouts.

### kol\_only

**403.** Your [callout settings](https://docs.cabalspy.xyz/cabalspy-id/callouts-settings.md) have `who: "kol_only"`, and the user does not have the KOL badge. See [KOL badge](https://docs.cabalspy.xyz/cabalspy-id/platform-users-kol.md).

### already\_called

**409.** The user called this token less than 24 hours ago. A user can call the same token once per 24 hours; a new callout is possible once the first day of the previous one is over (its `window_ends_at`). This rule applies whatever the settings.

### callout\_cooldown

**429.** The user made a callout less than `cooldown_minutes` ago (6 hours by default, see [callout settings](https://docs.cabalspy.xyz/cabalspy-id/callouts-settings.md)). The response carries a `Retry-After` header and `retry_after` in the error, both the seconds until the user can call again. Different from rate\_limit\_exceeded, which is about your API key.

### no\_price

**422.** The token has no market price yet, for example because it has not traded, so a callout could not be tracked. Try again once it trades.

### callout\_not\_found

**404.** No callout with this id in your instance, or it was removed. Removing a callout that is already removed answers with this code too.

## Trade Feed errors

These codes come from the [Trade Feed](https://docs.cabalspy.xyz/cabalspy-id/trade-feed-api.md) endpoints, the [Trade Feed widgets](https://docs.cabalspy.xyz/cabalspy-id/trade-feed-widgets.md) and from [copy settings](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-settings.md), which add the trader to the Trade Feed when needed. Their messages are written for end users, so you can show them as they are. The Trade Feed also uses [consent\_required](#consent_required), [plan\_user\_limit](#plan_user_limit), [platform\_user\_not\_found](#platform_user_not_found) and [rate\_limited](#rate_limited).

### trader\_not\_found

**404.** No active CabalSpy ID trader with this handle or csid\_id. Platform users of another platform can only be found when that platform switched on network sharing.

### cannot\_add\_self

**400.** The user tried to add themselves to their own Trade Feed, or to copy themselves.

### trading\_private

**403.** The trader keeps their trading private, so they cannot be added to a Trade Feed or copied. Traders already in a Trade Feed who switch to private stay listed with `trading_public: false`, but nothing of them shows until they are public again.

### trade\_feed\_full

**409.** The user's Trade Feed already has the maximum of 300 traders. Remove one first with [POST /v1/trade-feed/traders/delete](https://docs.cabalspy.xyz/cabalspy-id/trade-feed-api.md#remove-a-trader).

## Copy trading errors

These codes come from the [copy trading](https://docs.cabalspy.xyz/cabalspy-id/copy-trading.md) endpoints. Copy trading also uses [consent\_required](#consent_required), [platform\_user\_not\_found](#platform_user_not_found), [not\_found](#not_found) and the [Trade Feed errors](#trade-feed-errors).

### not\_in\_trade\_feed

**404.** [GET /v1/copy-trading/settings](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-settings.md#read-the-settings) with a `trader` who is not in the user's Trade Feed, so there are no copy settings for them. [POST /v1/copy-trading/settings](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-settings.md#change-the-settings) adds the trader automatically.

### copy\_managed\_elsewhere

**409.** Another platform copies this trader for this user, and each trader is copied by one platform at a time so the user is never copied twice. The user has to switch copying of this trader off on the other platform first. [GET /v1/copy-trading/settings](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-settings.md#read-the-settings) shows this as `managed_by_other_platform: true`. See [One platform at a time](https://docs.cabalspy.xyz/cabalspy-id/copy-trading.md#one-platform-at-a-time).

### already\_reported

**409.** The copy instruction was already reported with a different final status (`executed`, `failed` or `skipped`), and a final status cannot change. The message names the current status. Sending the same status again is not an error. See [Report the result](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-status.md).

## Stream errors

The [trades stream](https://docs.cabalspy.xyz/cabalspy-id/stream.md) sends errors as a message and then closes the connection with code 4403.

```json theme={null}
{ "event": "error", "error": { "code": "too_many_connections", "message": "At most 5 stream connections per API key." } }
```

It can also send invalid\_api\_key, invalid\_parameter (blockchain, events or mint), missing\_parameter (mint without blockchain) and scope\_not\_allowed, described above. The [callouts stream](https://docs.cabalspy.xyz/cabalspy-id/callouts-stream.md) sends errors the same way, with invalid\_api\_key, [feature\_not\_enabled](#feature_not_enabled), invalid\_parameter (chain or mint), missing\_parameter (mint without chain) and too\_many\_connections. The [Trade Feed stream](https://docs.cabalspy.xyz/cabalspy-id/trade-feed-api.md#live-stream) and the [copy trading stream](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-stream.md) send invalid\_api\_key and too\_many\_connections.

### plan\_required

The live stream is included from the Pro plan. Upgrade at [apidashboard.cabalspy.xyz/billing/csid](https://apidashboard.cabalspy.xyz/billing/csid).

### too\_many\_connections

Each API key can hold at most 5 stream connections at once, and separately 5 [theses stream](https://docs.cabalspy.xyz/cabalspy-id/theses-stream.md), 5 [callouts stream](https://docs.cabalspy.xyz/cabalspy-id/callouts-stream.md), 5 [Trade Feed stream](https://docs.cabalspy.xyz/cabalspy-id/trade-feed-api.md#live-stream) and 5 [copy trading stream](https://docs.cabalspy.xyz/cabalspy-id/copy-trading-stream.md) connections. Close unused connections, or share one connection across your services.

### too\_many\_tokens

Theses stream only: a subscribe frame would take the connection above 200 tokens. The frame is ignored and the connection stays open. Unsubscribe from tokens you no longer show, subscribe with `"all": true`, or open another connection.

### invalid\_frame

Theses stream only: the frame is not JSON or not a known op. Send `{"op": "subscribe", "tokens": [{"blockchain": "solana", "mint": "..."}]}`, `{"op": "unsubscribe", ...}`, `{"op": "subscribe", "all": true}` or `ping`. The connection stays open.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.