Sign in
DocsAPI

Account settings & KOLs

Read and change your sell setting and your tracked KOL wallets from code, and see what stays in the app.

Two account settings are on the API: how your sells are sent, and the KOL wallets you track. Reads need the read scope. Changes need trade.

Sell through another wallet#

This setting can send a sale through a temporary wallet. Your tokens move to a fresh wallet, that wallet sells, and the money comes back to you. On Solana each such sale is two transactions: one sends 0.01 SOL and the tokens to the temporary wallet, the other sells and sends all the SOL back. You pay network fees on both.

In the app this is Sell through another wallet on the Settings page.

GET /settings/trading:

{
  "sellThroughTemporaryWallet": true,
  "temporarySellMode": "custom",
  "temporarySellManual": {
    "simple": true, "uniqueWallet": false, "percentage": false, "sellAll": true,
    "sellAllExceptDev": true, "sellDev": false, "tradePanel": false
  },
  "temporarySellTasks": true,
  "temporarySellTaskTypes": { "volume": true, "dca": false, "…": true }
}
  • temporarySellMode — off, all (every sale) or custom (only the switches that are on).
  • temporarySellManual — one switch per kind of sale you make by hand. A sell sent through the API counts as simple.
  • temporarySellTasks — whether task sells use it.
  • temporarySellTaskTypes — one switch per task type: volume, warmup, antisniper, handswitcher, fakevolume, limit_order, ladder, mirror, dca and trailing_stop.
  • sellThroughTemporaryWallet — true whenever the mode is not off.

Change it#

PATCH /settings/trading takes one of two bodies.

The simple switch:

{ "sellThroughTemporaryWallet": true }

true sets the mode to all. false sets it to off.

Or the full setting, with every field:

{
  "temporarySellMode": "custom",
  "temporarySellManual": { "simple": true, "uniqueWallet": false, "percentage": false, "sellAll": true, "sellAllExceptDev": true, "sellDev": false, "tradePanel": false },
  "temporarySellTasks": false
}

temporarySellTaskTypes is optional here. The answer is the setting after the change. It applies to every sell after that.

Tracked wallets (KOLs)#

A KOL is a well-known trader. The terminal marks the wallets you track. See KOL tracker.

CallScopeWhat it does
GET /kolsreadYour tracked wallets. Paged with ?limit= and ?offset=.
POST /kolstradeTrack a wallet.
PATCH /kols/:addresstradeChange its name or emoji.
DELETE /kols/:addresstradeStop tracking it.

POST /kols:

{ "address": "7tXi4mbvppPBgYgTVj2NpYq9K1KYYQvHv6tfCpJv9kMT", "name": "Whale 1", "emoji": "🐳" }
  • address — 32 to 44 characters.
  • name — up to 64 characters. Optional.
  • emoji — up to 8 characters. Optional.

It answers 201 with { "kol": { … } }. Adding an address you already track updates its name and emoji.

PATCH /kols/:address takes name and emoji; null clears one. It answers { "kol": { … } }.

DELETE /kols/:address answers { "removed": "7tXi…" }.

An address you do not track gets 404.

What stays in the app#

  • API keys. You make, edit and revoke keys only in the app, while signed in. An API key cannot make keys.
  • Private keys. No API call returns a wallet's private key.
  • Your login, account profile, referrals and support tickets. These are app-only.

The Wallet Marketplace is on the API. See Wallet marketplace.

See also#