Wallet Group & Favorite Endpoints

Organize Solana wallets into named lists, such as smart money or snipers, and star your favorite wallets. Create, rename and delete wallet groups, add or remove their members, and manage the built-in favorites list shared with the app. Every call is free.

Paths are relative to https://terminal.raiden.wtf/api and every request carries your key in the X-API-Key header (see Authentication). Each call costs the credits shown next to it.

Wallet groups

List wallet groups

GET/wallet-groupsfree

Your wallet groups (named lists). The owner is your session wallet or the wallet bound to your API key.

Parameter	In	Description
`members`	query	`1` includes the members of each group.

Request


curl -s "https://terminal.raiden.wtf/api/wallet-groups?members=1" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{
  "data": [
    {
      "id": "smart-money-sol",
      "name": "Smart Money SOL",
      "count": 2,
      "created_at": "2026-06-21T09:41:14Z",
      "updated_at": "2026-06-27T12:03:55Z",
      "members": [
        {
          "wallet": "8psN…VRtf",
          "added_at": "0001-01-01T00:00:00Z"
        },
        {
          "wallet": "Cb3f…g9rE",
          "added_at": "0001-01-01T00:00:00Z"
        }
      ]
    }
  ]
}

Create a wallet group

POST/wallet-groupsfree

Creates a group.

Parameter	In	Description
`name`	body	Group name.
`id`	body	Optional. Your own ID for the group; generated if omitted.

Request


curl -s -X POST "https://terminal.raiden.wtf/api/wallet-groups" \
  -H "X-API-Key: $RAIDEN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Snipers"}'

Response


{
  "id": "grp_5f3a…", "name": "Snipers", "count": 0,
  "created_at": "2026-06-25T10:00:00Z", "updated_at": "2026-06-25T10:00:00Z", "members": []
}

Get a wallet group

GET/wallet-groups/{id}free

A single group with its members.

Parameter	In	Description
`id`	path	Group ID.

Request


curl -s "https://terminal.raiden.wtf/api/wallet-groups/grp_5f3a…" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{
  "id": "smart-money-watch",
  "name": "Smart Money Watch",
  "count": 2,
  "created_at": "2026-06-21T09:41:14Z",
  "updated_at": "2026-06-24T17:03:52Z",
  "members": [
    {
      "wallet": "8psN…VRtf",
      "note": "early sniper, high win-rate",
      "added_at": "2026-06-24T17:03:52Z"
    },
    {
      "wallet": "Cb3f…g9rE",
      "added_at": "2026-06-21T09:42:10Z"
    }
  ]
}

Rename a wallet group

PUT/wallet-groups/{id}free

Renames a group.

Parameter	In	Description
`id`	path	Group ID.
`name`	body	New group name.

Request


curl -s -X PUT "https://terminal.raiden.wtf/api/wallet-groups/grp_5f3a…" \
  -H "X-API-Key: $RAIDEN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Top snipers"}'

Response


{ "ok": true }

Delete a wallet group

DELETE/wallet-groups/{id}free

Deletes a group. Its members are removed too.

Parameter	In	Description
`id`	path	Group ID.

Request


curl -s -X DELETE "https://terminal.raiden.wtf/api/wallet-groups/grp_5f3a…" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{ "ok": true }

Group members

Add wallets to a group

POST/wallet-groups/{id}/walletsfree

Adds wallets to a group. The call is idempotent. Max 1000 wallets per group.

Parameter	In	Description
`id`	path	Group ID.
`wallets`	body	Wallet addresses to add.
`wallet`	body	A single wallet to add, instead of `wallets`.
`note`	body	Note for the single `wallet`.

To add one wallet with a note, send {"wallet":"…","note":"…"} instead of the wallets array.

Request


curl -s -X POST "https://terminal.raiden.wtf/api/wallet-groups/grp_5f3a…/wallets" \
  -H "X-API-Key: $RAIDEN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wallets":["8psN…VRtf","Cb3f…g9rE"]}'

Response


{ "ok": true, "added": 2 }

Remove a wallet from a group

DELETE/wallet-groups/{id}/wallets/{wallet}free

Removes one wallet from a group.

Parameter	In	Description
`id`	path	Group ID.
`wallet`	path	Wallet address to remove.

Request


curl -s -X DELETE "https://terminal.raiden.wtf/api/wallet-groups/grp_5f3a…/wallets/8psN…VRtf" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{ "ok": true }

Favorites

List favorite wallets

GET/wallet-favoritesfree

Your ★ favorite wallets and their aliases: the built-in list, shared with the in-app ☆.

Request


curl -s "https://terminal.raiden.wtf/api/wallet-favorites" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{
  "data": [
    {
      "wallet": "8psN…VRtf",
      "alias": "Cb3f…g9rE"
    }
  ]
}

Add a favorite wallet

POST/wallet-favoritesfree

Stars a wallet.

Parameter	In	Description
`wallet`	body	Wallet address to star.
`alias`	body	Optional alias for the wallet.

Request


curl -s -X POST "https://terminal.raiden.wtf/api/wallet-favorites" \
  -H "X-API-Key: $RAIDEN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wallet":"8psN…VRtf","alias":"whale #1"}'

Response


{ "ok": true }

Remove a favorite wallet

DELETE/wallet-favorites/{wallet}free

Unstars a wallet.

Parameter	In	Description
`wallet`	path	Wallet address to unstar.

Request


curl -s -X DELETE "https://terminal.raiden.wtf/api/wallet-favorites/8psN…VRtf" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{ "ok": true }