Leader Earnings

The /leader/earnings/:leaderID endpoint returns the leader's daily ROI in USD over a specified number of days. Each ROI value represents a full UTC day (00:00:00 to 23:59:59).

This endpoint is useful for tracking a leader’s performance on a day-to-day basis, with the most recent entries first.

Method

GET /leader/earnings/:leaderID

• :leaderID — the unique identifier of the leader whose earnings data is to be fetched.

Query Parameters

• before — (optional) Upper bound (exclusive) ISO 8601 timestamp for data retrieval. Defaults to current UTC time.
• limit — (optional) Number of daily entries to return. Defaults to 30. Maximum allowed: 50.

Response

{
  "status": 200,
  "data": [
    {
      "day": "2025-05-14T00:00:00Z",
      "pnl": "-0.85"
    },
    {
      "day": "2025-05-13T00:00:00Z",
      "pnl": "3.93"
    }
  ]
}

Fields Explained

day

Date of the ROI entry in ISO 8601 format (UTC).

roi

Daily ROI value in USD (string). Negative values indicate a loss.