Skip to main content
PATCH
/
api
/
v1
/
traders
/
{wallet}
Update follow settings
curl --request PATCH \
  --url https://carboncopy.news/api/v1/traders/{wallet} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "copyPercentage": 50,
  "maxCopyAmount": 123,
  "notificationsEnabled": true,
  "copyTradingEnabled": true
}
'
{
  "walletAddress": "0xAbCd1234...",
  "copyTradingEnabled": true,
  "copyPercentage": 25,
  "displayName": "alpha_trader",
  "maxCopyAmount": 500,
  "totalCopied": 14,
  "pnl": 128.4,
  "notificationsEnabled": true,
  "followedAt": 1741500000000,
  "recentTrades": [
    {
      "id": "k17abc123def456",
      "traderWallet": "0xAbCd1234...",
      "marketId": "0x1234abcd...",
      "side": "YES",
      "amount": 50,
      "status": "open",
      "createdAt": 1741550000000,
      "marketQuestion": "Will BTC exceed $100k by end of 2025?",
      "price": 0.62,
      "pnl": 12.5,
      "orderId": "k17xyz789",
      "resolvedAt": 123
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key in the format cc_<64 hex characters>. Obtain from the Dashboard under Settings → API Keys.

Path Parameters

​
wallet
string
required

Trader's Ethereum wallet address (full or prefix match).

Example:

"0xAbCd1234..."

Body

application/json
​
copyPercentage
number
Required range: 0 <= x <= 100
​
maxCopyAmount
number | null

Set to null to remove the cap.

​
notificationsEnabled
boolean
​
copyTradingEnabled
boolean

Enable or disable copy trading for this specific trader.

Response

Updated trader settings.

​
walletAddress
string
required

Trader's Ethereum wallet address.

Example:

"0xAbCd1234..."

​
copyTradingEnabled
boolean
required

true if copy trading is currently active for this trader.

​
copyPercentage
number
required

Percentage of each trade to copy.

Required range: 0 <= x <= 100
Example:

25

​
displayName
string | null

Optional display name for the trader.

Example:

"alpha_trader"

​
maxCopyAmount
number | null

Maximum USDC to deploy per copied trade. null means no cap.

Example:

500

​
totalCopied
integer

Total number of trades copied from this trader.

Example:

14

​
pnl
number

P&L in USDC from trades copied from this trader.

Example:

128.4

​
notificationsEnabled
boolean

Whether push/email notifications are enabled for this trader's activity.

​
followedAt
integer

Unix timestamp (ms) when you started following this trader.

Example:

1741500000000

​
recentTrades
object[]

The 10 most recent trades by this trader.