Copier Earnings

The /user/copier/earnings/:id endpoint returns the copier'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 copier's performance on a day-to-day basis, with the most recent entries first.

Method

GET /user/copier/earnings/:id

• :id — the unique identifier of the copier bot 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",
      "roi": "-0.85"
    },
    {
      "day": "2025-05-13T00:00:00Z",
      "roi": "3.93"
    },
    {
      "day": "2025-05-12T00:00:00Z",
      "roi": "-2.43"
    },
    {
      "day": "2025-05-11T00:00:00Z",
      "roi": "-0.03"
    },
    {
      "day": "2025-05-10T00:00:00Z",
      "roi": "0.02"
    },
    {
      "day": "2025-05-09T00:00:00Z",
      "roi": "-0.01"
    },
    {
      "day": "2025-05-08T00:00:00Z",
      "roi": "0.23"
    },
    {
      "day": "2025-05-07T00:00:00Z",
      "roi": "0.11"
    }
  ]
}

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.