Add and remove wallets

{
  "success": true,
  "data": {
    "external_id": "user_8412",
    "wallets_added": [
      { "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01", "family": "evm", "chains": ["base", "eth"], "source": "dynamic" }
    ],
    "wallets": [
      {
        "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
        "family": "solana",
        "chains": ["solana"],
        "verified": false,
        "verified_chains": [],
        "status": "active",
        "counts": true,
        "source": "privy",
        "verified_at": null,
        "added_at": "2026-10-24T09:12:40Z"
      },
      {
        "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01",
        "family": "evm",
        "chains": ["base", "eth"],
        "verified": false,
        "verified_chains": [],
        "status": "active",
        "counts": true,
        "source": "dynamic",
        "verified_at": null,
        "added_at": "2026-10-26T08:04:11Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-26T08:04:11Z"
  }
}

{
  "success": true,
  "data": {
    "external_id": "user_8412",
    "wallets_added": [
      { "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01", "family": "evm", "chains": ["base", "eth"], "source": "dynamic" }
    ],
    "wallets": [
      {
        "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
        "family": "solana",
        "chains": ["solana"],
        "verified": false,
        "verified_chains": [],
        "status": "active",
        "counts": true,
        "source": "privy",
        "verified_at": null,
        "added_at": "2026-10-24T09:12:40Z"
      },
      {
        "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01",
        "family": "evm",
        "chains": ["base", "eth"],
        "verified": false,
        "verified_chains": [],
        "status": "active",
        "counts": true,
        "source": "dynamic",
        "verified_at": null,
        "added_at": "2026-10-26T08:04:11Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-26T08:04:11Z"
  }
}

Add wallets your user already has, from Privy, Dynamic or any other provider, without a payment. They are unverified and count straight away unless your instance sets wallet_trust to verified_only, see Unverified and verified wallets. To prove ownership with a payment, use Verify a wallet.

Add wallets

POST /v1/platform-users/wallets/add Adding a wallet that already exists only adds the chains that are new. A user can hold up to 5 Solana and 5 EVM wallets.

Body

string

required

Your id of the user. Alternatively pass csid_id.

array

required

1 to 10 wallets, objects with address, chains and source, or plain addresses. See Create or update a user. For a single wallet you can instead pass address, chains and source at the top level.

Usage Example

curl -X POST "https://api-id.cabalspy.xyz/v1/platform-users/wallets/add" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "user_8412",
    "wallets": [{"address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01", "chains": ["base", "eth"], "source": "dynamic"}]
  }'

import requests

r = requests.post("https://api-id.cabalspy.xyz/v1/platform-users/wallets/add",
                  json={"external_id": "user_8412", "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01"},
                  headers={"Authorization": "Bearer YOUR_KEY"})
print(r.status_code, r.json()["data"]["wallets_added"])

const res = await fetch("https://api-id.cabalspy.xyz/v1/platform-users/wallets/add", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    external_id: "user_8412",
    wallets: ["0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01"],
  }),
});
const { data } = await res.json();
console.log(res.status, data.wallets_added, data.wallets.length);

Response

201 when something was added, 200 when every wallet and chain already existed.

object

Show data

string

Your id of the user.

array

Wallets and chains that are new: address, family, chains and source.

array

All the user’s wallets with their status, as in the user object.

{
  "success": true,
  "data": {
    "external_id": "user_8412",
    "wallets_added": [
      { "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01", "family": "evm", "chains": ["base", "eth"], "source": "dynamic" }
    ],
    "wallets": [
      {
        "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
        "family": "solana",
        "chains": ["solana"],
        "verified": false,
        "verified_chains": [],
        "status": "active",
        "counts": true,
        "source": "privy",
        "verified_at": null,
        "added_at": "2026-10-24T09:12:40Z"
      },
      {
        "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01",
        "family": "evm",
        "chains": ["base", "eth"],
        "verified": false,
        "verified_chains": [],
        "status": "active",
        "counts": true,
        "source": "dynamic",
        "verified_at": null,
        "added_at": "2026-10-26T08:04:11Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-26T08:04:11Z"
  }
}

Each new wallet triggers the wallet.added webhook.

Remove a wallet

POST /v1/platform-users/wallets/delete Removes one wallet, verified or not, from the user. Every user needs at least one wallet, so the last one cannot be removed: add another first, or delete the user.

string

required

Your id of the user. Alternatively pass csid_id.

string

required

The wallet to remove.

curl -X POST "https://api-id.cabalspy.xyz/v1/platform-users/wallets/delete" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"external_id": "user_8412", "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01"}'

import requests

r = requests.post("https://api-id.cabalspy.xyz/v1/platform-users/wallets/delete",
                  json={"external_id": "user_8412", "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01"},
                  headers={"Authorization": "Bearer YOUR_KEY"})
print(r.json()["data"])

const res = await fetch("https://api-id.cabalspy.xyz/v1/platform-users/wallets/delete", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ external_id: "user_8412", address: "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01" }),
});
console.log((await res.json()).data.removed);

Response

{
  "success": true,
  "data": {
    "external_id": "user_8412",
    "address": "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01",
    "removed": true
  },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-26T08:10:02Z" }
}

Errors

Status	Code	Meaning
400	missing_parameter	external_id or address missing.
400	invalid_parameter	A wallet’s chains or source invalid, or more than 10 wallets.
400	wallet_required	Add: no wallets passed.
400	invalid_address	Not a valid Solana or EVM address.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
404	platform_user_not_found	No user with this id in your instance.
404	wallet_not_found	Remove: the user has no such wallet.
409	account_claimed	The person claimed the account and manages it themselves.
409	too_many_wallets	The user would have more than 5 Solana or 5 EVM wallets.
409	last_wallet	Remove: this is the user’s only wallet.
429	rate_limit_exceeded	Rate limit exceeded.

See Errors for the full list.

Introduction

Login

Data API

Users

Trading

Theses

Streams

White-Label

Competitions

Reference

Add and remove wallets

Add wallets

Body

Usage Example

Response

Remove a wallet

Errors

​Add wallets

​Body

​Usage Example

​Response

​Remove a wallet

​Errors

Add wallets

Body

Usage Example

Response

Remove a wallet

Errors