API reference · v5

Bitget Copy Trading API

Bitget futures copy trading, classic elite traders and portfolios alike: rankings and leaderboards, profiles, performance, positions and history.

Base URL https://api.kopyon.com/v5/bitget-copy-trading/ · send your key in the X-API-KEY header · trader id: The traderUid or portfolio id in the trader's Bitget URL.

Get a free API key · Interactive reference with Try it · Authentication, paging and errors

Traders

GET /v5/bitget-copy-trading/traders

Bitget's futures elite traders, classic traders and portfolios alike, and their figures over a period; or, with ranking, one of its leaderboards.

Query parameters

Name	Type	Description
`period`required	enum	Days the figures cover7D, 30D, 90D, 180D
`sortBy`	enumdefault pnl	What to rank by, highest firstpnl, roi, aum, copierPnl
`ranking`	enum	One of Bitget's leaderboards instead of the whole list: its top 50 classic traders by PnL, ROI or copiers' PnL, or the new elite traders. sortBy is then ignoredpnl, roi, copierPnl, newTraders
`page`	intdefault 1	Page number
`rows`	intdefault 20	Rows per page1 to 20

Response fields, in `data`

Field	Type	Description
`traders[]`always	array
`traders[].traderId`always	string	The trader's id at the source; other operations take it as traderId
`traders[].name`always	string	Display name
`traders[].avatarUrl`	string
`traders[].roi`	number
`traders[].pnl`	number
`traders[].sourceDetails.kind`	only Bitget
`traders[].sourceDetails.score`	only Bitget
`traders[].aum`	number
`traders[].maxDrawdown`	number
`traders[].winRate`	number
`traders[].copierPnl`	number
`traders[].copiers`	number	Current copiers
`traders[].maxCopiers`	number
`traders[].rank`	number
`hasMore`always	boolean	true when another page follows

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bitget-copy-trading/traders?period=7D"

{
  "data": {
    "traders": [
      {
        "traderId": "1487421647958179840",
        "name": "QIUAQ",
        "avatarUrl": "https://img.bgstatic.com/otc/images/20250125/1737783340528.png",
        "roi": 2.318,
        "pnl": 94100.37,
        "copierPnl": 0,
        "aum": 57258.56,
        "maxDrawdown": 0.16,
        "winRate": 0.375,
        "copiers": 0,
        "maxCopiers": 500,
        "sourceDetails": {
          "kind": "portfolio",
          "score": 0
        }
      },
      {
        "traderId": "b0b246728fb43a53a396",
        "name": "Armandino",
        "avatarUrl": "https://img.bgstatic.com/otc/images/20261015/1792036990791.png",
        "roi": 0.6108,
        "pnl": 60781.79,
        "copierPnl": 47345.45,
        "aum": 27306.16,
        "maxDrawdown": 0.1309,
        "winRate": 1,
        "copiers": 132,
        "maxCopiers": 600,
        "sourceDetails": {
          "kind": "classic",
          "score": 100
        }
      },
      {
        "traderId": "bfb04e768aba3053a691",
        "name": "AiTader",
        "avatarUrl": "https://img.bgstatic.com/otc/images/20261015/1792048653796.png",
        "roi": 0.438,
        "pnl": 43505.22,
        "copierPnl": 34271.04,
        "aum": 21254,
        "maxDrawdown": 0.1311,
        "winRate": 1,
        "copiers": 108,
        "maxCopiers": 600,
        "sourceDetails": {
          "kind": "classic",
          "score": 100
        }
      }
    ],
    "hasMore": true
  }
}

Search traders

GET /v5/bitget-copy-trading/traderSearch

Elite traders, classic and portfolios, whose name or username contains this, in Bitget's order. Bitget does not say which period the figures cover.

Query parameters

Name	Type	Description
`name`required	string	Part of the trader's name or username
`page`	intdefault 1	Page number
`rows`	intdefault 20	Rows per page1 to 20

Response fields, in `data`

Field	Type	Description
`traders[]`always	array
`traders[].traderId`always	string	The trader's id at the source; other operations take it as traderId
`traders[].name`always	string	Display name
`traders[].avatarUrl`	string
`traders[].roi`	number
`traders[].pnl`	number
`traders[].sourceDetails.kind`	only Bitget
`traders[].sourceDetails.score`	only Bitget
`traders[].aum`	number
`traders[].maxDrawdown`	number
`traders[].winRate`	number
`traders[].copierPnl`	number
`traders[].copiers`	number	Current copiers
`traders[].maxCopiers`	number
`hasMore`always	boolean	true when another page follows

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bitget-copy-trading/traderSearch?name=QIUA"

{
  "data": {
    "traders": [
      {
        "traderId": "1487421647958179840",
        "name": "QIUAQ",
        "avatarUrl": "https://img.bgstatic.com/otc/images/20250125/1737783340528.png",
        "roi": 3.1229,
        "pnl": 85655.7,
        "copierPnl": -42.35,
        "winRate": 0.3636,
        "maxDrawdown": 0.63,
        "copiers": 0,
        "maxCopiers": 500,
        "sourceDetails": {
          "kind": "portfolio"
        }
      }
    ],
    "hasMore": false
  }
}

Trader profile

GET /v5/bitget-copy-trading/traderProfile

The trader's name, copiers, profit share and copiers' assets.

Query parameters

Name	Type	Description
`traderId`required	string	A classic trader's traderUid (hex) or a portfolio's portfolioId (digits), from traders

Response fields, in `data`

Field	Type	Description
`traderId`always	string
`name`	string
`avatarUrl`	string
`sourceDetails.kind`	only Bitget
`sourceDetails.daysActive`	only Bitget
`sourceDetails.positionsHidden`	only Bitget
`copiers`	number
`maxCopiers`	number
`totalCopiers`	number
`aum`	number
`profitShare`	number

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bitget-copy-trading/traderProfile?traderId=1487421647958179840"

{
  "data": {
    "traderId": "1487421647958179840",
    "name": "QIUAQ",
    "avatarUrl": "https://img.bgstatic.com/otc/images/20250125/1737783340528.png",
    "copiers": 0,
    "maxCopiers": 500,
    "profitShare": 0.15,
    "aum": 57258.56,
    "sourceDetails": {
      "kind": "portfolio",
      "daysActive": 24
    }
  }
}

Performance

GET /v5/bitget-copy-trading/performance

Return, PnL, drawdown, win rate, trades and what copiers made over a period.

Query parameters

Name	Type	Description
`traderId`required	string	A classic trader's traderUid (hex) or a portfolio's portfolioId (digits), from traders
`period`required	enum	Days the figures cover7D, 30D, 90D, 180D

Response fields, in `data`

Field	Type	Description
`period`always	string
`roi`	number
`pnl`	number
`maxDrawdown`	number
`copierPnl`	number
`winRate`	number
`wins`	number
`trades`	number
`losses`	number

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bitget-copy-trading/performance?traderId=1487421647958179840&period=7D"

{
  "data": {
    "period": "7D",
    "roi": 2.318,
    "pnl": 94100.37,
    "maxDrawdown": 0.1600181346851229,
    "winRate": 0.375,
    "copierPnl": 0,
    "trades": 8,
    "wins": 3
  }
}

Chart

GET /v5/bitget-copy-trading/traderChart

Cumulative ROI or PnL, one point a day of the period, oldest first. A classic trader's starts at the period's start; a portfolio's counts from when the portfolio began.

Query parameters

Name	Type	Description
`traderId`required	string	A classic trader's traderUid (hex) or a portfolio's portfolioId (digits), from traders
`period`required	enum	Days the figures cover7D, 30D, 90D, 180D
`metric`	enumdefault ROI	ROI as a fraction, or PnL in USDTROI, PNL

Response fields, in `data`

Field	Type	Description
`metric`always	string	What the points measure: ROI, PNL or BALANCE
`points[]`always	array
`points[].timestamp`always	number	Point time, in Unix milliseconds
`points[].value`always	number

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bitget-copy-trading/traderChart?traderId=1487421647958179840&period=7D"

{
  "data": {
    "metric": "ROI",
    "points": [
      {
        "timestamp": 1791820800000,
        "value": 0.9969
      },
      {
        "timestamp": 1791907200000,
        "value": 1.5557
      },
      {
        "timestamp": 1791993600000,
        "value": 1.2755
      }
    ]
  }
}

Open positions

GET /v5/bitget-copy-trading/openPositions

A portfolio's open positions, or a classic trader's open copy orders, one per order. unrealizedPnl is worked out from Bitget's mark price, as its site does, and a portfolio's roi is it over margin; Bitget's per-order ROI for classic traders is not, so they have none. A trader can hide them; then positions is empty and hidden is true.

Query parameters

Name	Type	Description
`traderId`required	string	A classic trader's traderUid (hex) or a portfolio's portfolioId (digits), from traders

Response fields, in `data`

Field	Type	Description
`positions[]`always	array
`positions[].symbol`always	string
`positions[].side`always	LONG \| SHORT
`positions[].size`	number	Position size, always positive; side gives the direction
`positions[].entryPrice`always	number
`positions[].markPrice`	number	The exchange's mark price
`positions[].leverage`	number
`positions[].marginMode`	ISOLATED \| CROSS
`positions[].unrealizedPnl`	number	In pnlCurrency
`positions[].pnlCurrency`	string
`positions[].margin`	number	Margin the position uses, in pnlCurrency
`positions[].roi`	number	unrealizedPnl over margin, as a fraction. Where the exchange sends its own (KuCoin; BingX, over the opening margin), it is passed on and can differ from that ratio
`positions[].sourceDetails.orderId`	only Bitget
`positions[].sourceDetails.realizedPnl`	only Bitget
`positions[].openedAt`	number
`positions[].fundingPnl`	number
`positions[].tradingFee`	number	Fee paid to open, as a positive cost
`hidden`always	boolean	true when the trader hides positions

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bitget-copy-trading/openPositions?traderId=1487421647958179840"

{
  "data": {
    "positions": [
      {
        "symbol": "ETHUSDT",
        "side": "SHORT",
        "size": 124.05,
        "entryPrice": 2477.83295536988,
        "markPrice": 2371.33,
        "leverage": 75,
        "marginMode": "CROSS",
        "margin": 4032.49112743,
        "unrealizedPnl": 13211.6916136336,
        "pnlCurrency": "USDT",
        "roi": 3.2763101508,
        "openedAt": 1792150904619,
        "fundingPnl": 120.3062401199,
        "tradingFee": 448.2492735,
        "sourceDetails": {
          "realizedPnl": 11011.627338157597
        }
      },
      {
        "symbol": "BTCUSDT",
        "side": "SHORT",
        "size": 5.9154,
        "entryPrice": 85568.15969421674,
        "markPrice": 81089.6,
        "leverage": 75,
        "marginMode": "CROSS",
        "margin": 6575.57796364,
        "unrealizedPnl": 26492.4720151697,
        "pnlCurrency": "USDT",
        "roi": 4.0289191553,
        "openedAt": 1790518257731,
        "fundingPnl": 1388.55276043558,
        "tradingFee": 1244.946242622,
        "sourceDetails": {
          "realizedPnl": 19760.124243781098
        }
      }
    ],
    "hidden": false
  }
}

Position history

GET /v5/bitget-copy-trading/positionHistory

A portfolio's closed positions, with funding and net PnL, or a classic trader's closed copy orders, one per order, newest first.

Query parameters

Name	Type	Description
`traderId`required	string	A classic trader's traderUid (hex) or a portfolio's portfolioId (digits), from traders
`cursor`	string	The nextCursor of the previous answer; leave it out for the first page
`rows`	intdefault 20	Rows per page1 to 20

Response fields, in `data`

Field	Type	Description
`positions[]`always	array
`positions[].positionId`	string
`positions[].symbol`always	string
`positions[].side`	LONG \| SHORT
`positions[].status`	string
`positions[].marginMode`	ISOLATED \| CROSS
`positions[].leverage`	number
`positions[].roi`	number
`positions[].entryPrice`	number
`positions[].closePrice`	number
`positions[].openedAt`always	number	When the position opened, in Unix milliseconds
`positions[].closedAt`	number	When the position closed, in Unix milliseconds
`positions[].updatedAt`always	number	Last change, in Unix milliseconds
`positions[].openedVolume`	number
`positions[].closedVolume`	number
`positions[].maxOpenInterest`	number
`positions[].grossPnl`	number
`positions[].fundingPnl`	number
`positions[].tradingFee`	number
`positions[].liquidationFee`	number
`positions[].netPnl`	number
`positions[].pnlCurrency`	string
`positions[].sourceDetails.netProfit`	only Bitget
`positions[].sourceDetails.fundingFee`	only Bitget
`positions[].sourceDetails.positionAveragePrice`	only Bitget
`nextCursor`	string	Send it back as cursor, with the same query, to read the next page; absent on the last page

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bitget-copy-trading/positionHistory?traderId=1487421647958179840"

{
  "data": {
    "positions": [
      {
        "positionId": "1494954416955965440",
        "symbol": "ETHUSDT",
        "side": "SHORT",
        "marginMode": "CROSS",
        "leverage": 75,
        "entryPrice": 2480.054320287341,
        "closePrice": 2478.391794656874,
        "openedAt": 1792148324784,
        "closedAt": 1792150828546,
        "updatedAt": 1792150828546,
        "closedVolume": 668.15,
        "grossPnl": 1110.816499986889,
        "fundingPnl": 0,
        "tradingFee": 1242.3696643875,
        "netPnl": -131.55316440061085,
        "pnlCurrency": "USDT",
        "sourceDetails": {}
      },
      {
        "positionId": "1494940094838063104",
        "symbol": "ETHUSDT",
        "side": "SHORT",
        "marginMode": "CROSS",
        "leverage": 75,
        "entryPrice": 2458.850901941671,
        "closePrice": 2468.989695177112,
        "openedAt": 1792138008387,
        "closedAt": 1792147413631,
        "updatedAt": 1792147413631,
        "closedVolume": 143.69,
        "grossPnl": -1456.843200001294,
        "fundingPnl": 0,
        "tradingFee": 265.530530775,
        "netPnl": -1722.373730776294,
        "pnlCurrency": "USDT",
        "sourceDetails": {}
      },
      {
        "positionId": "1494302934845865984",
        "symbol": "SAMSUNGUSDT",
        "side": "LONG",
        "marginMode": "CROSS",
        "leverage": 20,
        "entryPrice": 176.532235333329,
        "closePrice": 169.904682666665,
        "openedAt": 1791907261257,
        "closedAt": 1791995503089,
        "updatedAt": 1791995503089,
        "closedVolume": 150,
        "grossPnl": -994.1329000007,
        "fundingPnl": 15.499356,
        "tradingFee": 19.4870766375,
        "netPnl": -998.1206206382,
        "pnlCurrency": "USDT",
        "sourceDetails": {}
      }
    ]
  }
}

Transfer history

GET /v5/bitget-copy-trading/transferHistory

A portfolio's funds added from or moved back to the trader's spot account, newest first; Bitget keeps 180 days. Classic traders have none (422).

Query parameters

Name	Type	Description
`traderId`required	string	A classic trader's traderUid (hex) or a portfolio's portfolioId (digits), from traders
`cursor`	string	The nextCursor of the previous answer; leave it out for the first page
`rows`	intdefault 20	Rows per page1 to 20

Response fields, in `data`

Field	Type	Description
`transfers[]`always	array
`transfers[].time`always	number	In Unix milliseconds
`transfers[].asset`	string
`transfers[].amount`always	number
`transfers[].from`	string
`transfers[].to`	string
`transfers[].type`always	deposit \| withdraw \| transfer \| vaultDeposit \| vaultWithdraw \| commission \| other	deposit and withdraw move the owner's money into or out of the account; transfer, to or from another address; vaultDeposit and vaultWithdraw, into or out of a vault; commission is a vault leader's share; other is a kind none of these fits, named in sourceDetails.type
`nextCursor`	string	Send it back as cursor, with the same query, to read the next page; absent on the last page

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bitget-copy-trading/transferHistory?traderId=1487421647958179840"

{
  "data": {
    "transfers": []
  }
}

Stream and webhooks

Paid plans can follow a trader in real time over wss://api.kopyon.com/v5/streamor through signed webhooks. Topics for this source:

openPositions: Open positions, whenever they change
positionEvents: Opened, increased, decreased, closed
positionHistory: Newly closed positions

Stream messages and webhook signatures

Bitget Copy Trading API

Traders

Query parameters

Response fields, in data

Example

Search traders

Query parameters

Response fields, in data

Example

Trader profile

Query parameters

Response fields, in data

Example

Performance

Query parameters

Response fields, in data

Example

Chart

Query parameters

Response fields, in data

Example

Open positions

Query parameters

Response fields, in data

Example

Position history

Query parameters

Response fields, in data

Example

Transfer history

Query parameters

Response fields, in data

Example

Stream and webhooks

Try the Bitget Copy Trading API for free.

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`