Skip to main content
GET
/
api
/
v1
/
portfolio
Get portfolio summary
curl --request GET \
  --url https://carboncopy.news/api/v1/portfolio \
  --header 'Authorization: Bearer <token>'
{
  "totalValue": 5420.75,
  "activePositions": 12,
  "totalPnL": 420.5,
  "totalPnLPercent": 8.41,
  "winRate": 62.5,
  "totalTrades": 48,
  "traders": [
    {
      "walletAddress": "0xAbCd1234...",
      "copyTradingEnabled": true,
      "copyPercentage": 25,
      "displayName": "alpha_trader",
      "maxCopyAmount": 500,
      "totalCopied": 14,
      "pnl": 128.4
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Response

Portfolio summary.

​
totalValue
number
required

Current portfolio value in USDC.

Example:

5420.75

​
activePositions
integer
required

Number of currently open copy-trade positions.

Example:

12

​
totalPnL
number
required

Lifetime profit/loss in USDC.

Example:

420.5

​
totalPnLPercent
number
required

Lifetime P&L as a percentage of invested capital.

Example:

8.41

​
winRate
number
required

Percentage of resolved copy trades that were profitable.

Example:

62.5

​
totalTrades
integer
required

Total number of copy trades executed.

Example:

48

​
traders
object[]
required

Summary stats for each followed trader.