Seven REST endpoints over the Binance Smart Money leaderboard: rankings, positions and order history. Every one runs from this page without a key. Request an API key.
Base URL
Every endpoint is a GET with query parameters.
https://api.kopyon.com/v4/Production
Every response has the same envelope: the payload under data, with message and success alongside it. A row that does not say optional is required, or always present.
Authentication
APIKeyHeaderapiKey · header
NameX-API-KEY
Value
Optional.
Rate limits
The rate is per minute, per endpoint path: exhaust one and the other six still answer. The monthly quota is account-wide.
Plan
Price
Requests / minute, per endpoint
Requests / month, account-wide
Free
$0/mo
120
10,000
Developer
$49/mo
600
5,000,000
Trading Desk
$299/mo
1,800
50,000,000
Flat out at its per-minute rate, a plan spends its month in a day or two.
What every response tells you
Everything except Retry-After comes back on every metered response, so a client can pace itself.
Header
Meaning
X-RateLimit-Limit
Requests allowed in the current window, for this endpoint.
X-RateLimit-Remaining
Requests left in that window.
X-RateLimit-Reset
When that window resets, as a Unix timestamp in seconds.
X-RateLimit-Window
The granularity of that window: minute on every plan, day without a key.
X-RateLimit-Limit-Month
Requests allowed this month, across every endpoint.
X-RateLimit-Remaining-Month
Requests left this month.
X-RateLimit-Reset-Month
When the monthly quota resets.
Retry-After
Seconds to wait before retrying. On a 429 only.
The -Month headers need a key; unmetered paths like health send none. Resets are Unix seconds. Your month is 30 days from your first call, so the monthly one will not land on the 1st. All eight reach browser JavaScript.
Status codes
Code
Meaning
When you see it
200
Success
401
Unauthorized
Sending no key is fine; only an unrecognised one 401s.
422
Validation error
A parameter is missing, out of range, or not in its enum.
429
Rate limit exceeded
The rate window, or the monthly quota. Retry-After says how long to wait.
500
Internal server error
An upstream failure reaching Binance. Safe to retry with backoff.
The 422 body
Identical on all seven endpoints.
Field
Type
detail
arrayoptional
detail[].loc
array
detail[].msg
string
detail[].type
string
List & Search
Endpoints to discover and find traders.
GET/v4/tradersList
The leaderboard itself: traders ranked by PNL or ROI over a window you pick.