API reference · v5Kopyon API reference
Trader data from 16 sources in one JSON format. These pages list every route; the interactive reference in the console adds the stream messages and a Try it button.
Authentication
Every route is a GET under https://api.kopyon.com/v5/{source}/. Send your key in theX-API-KEY header. Keys are free in the console, with 10,000 requests a month on the free plan; without a key each route answers 10 calls a day per IP.
Paging
Rankings (traders, traderSearch) take page androws and answer hasMore, plus total when the exchange gives it. Histories (positionHistory, orderHistory,transferHistory) answer nextCursor: send it back ascursor with the same query to read the next page. rows defaults to 20, or to the exchange's maximum when lower.
Shared conventions
Every source takes period with the same values (30m, 1h, 1D, 3D, 7D, 30D, 90D, 180D, 1Y, ALL), each source those its exchange has. Symbols are base and quote with no separator (BTCUSDT). Fees are positive costs, funding is signed, and netPnlappears only when every cost is known. A value the exchange does not send is left out rather than sent as null, and data only one exchange has goes in sourceDetails. Where a trader hides positions or history, the answer carries hidden: true.
Errors
Errors answer {"error": {"code", "message"}}: 401 for a missing or invalid key, 403 when the key's IP list or scopes refuse the call, 404 for an unknown trader, 422 for an invalid parameter, 429 past a rate limit or quota, and 503 when the exchange is unavailable.
References by source
Leaderboard
- Binance Smart Money traders, traderSearch, traderProfile, traderChart, openPositions, positionHistory, orderHistory
- Bybit Leaderboard traders, traderSearch, traderProfile, traderChart, openPositions
Copy trading
- Binance Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory, orderHistory, transferHistory
- OKX Copy Trading traders, traderProfile, performance, traderChart, openPositions, positionHistory, orderHistory
- Bybit Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory
- Bitget Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory, transferHistory
- Gate Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory, orderHistory, transferHistory
- BingX Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory, orderHistory, transferHistory
- MEXC Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory
- KuCoin Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory
- HTX Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory, orderHistory, transferHistory
- BloFin Copy Trading traders, traderSearch, traderProfile, performance, traderChart, openPositions, positionHistory
On-chain
- Hyperliquid traders, performance, traderChart, openPositions, orderHistory, positionHistory, transferHistory, traderSearch, traderProfile
- Hyperliquid Vaults traders, performance, traderChart, openPositions, orderHistory, positionHistory, transferHistory, traderSearch, traderProfile
- dYdX traderProfile, traderChart, openPositions, positionHistory, transferHistory, orderHistory