---
title: "Get signal provider earnings breakdown"
method: GET
path: "/rest/api/v1/signals/{signalProviderId}/earnings"
tags: ["Signal API"]
---

# Get signal provider earnings breakdown

`GET /rest/api/v1/signals/{signalProviderId}/earnings`

Returns earnings breakdown for a signal provider including gross/net amounts, per-follower charge details, and monthly breakdown. Includes PAID, OPEN, and VOID invoices. If month and year are not provided, returns all-time earnings.

## Path parameters

- `signalProviderId` string, uuid, required

## Query parameters

- `month` integer
- `year` integer

## Response `200`

OK

- SignalProviderEarningsDTO — Signal provider earnings breakdown
  - `billingModel` string — Billing model: MONTHLY_PROFIT or HIGH_WATERMARK
  - `currency` string — Currency of all monetary amounts
  - `monthlyBreakdown` MonthlyEarningsDTO[] — Per-month earnings breakdown with individual follower charge details
    - `coveredFollowerCosts` number — Costs the signal provider covers for hosting follower accounts (only when coverFollowerCosts is enabled)
    - `followerCharges` FollowerChargeDetailDTO[] — Individual charge details per follower for this month
      - `billingModel` string — Billing model applied: MONTHLY_PROFIT or HIGH_WATERMARK
      - `currentCumulativeProfit` number — HIGH_WATERMARK only: current cumulative profit level from subscription start
      - `followerAccountId` string, uuid — UUID of the follower's trading account
      - `followerEmail` string — Email of the follower's project owner (obfuscated for public providers, full for allowed customers)
      - `followerProfit` number — Profit generated by this follower's account during the billing period
      - `invoiceId` integer — Internal invoice ID (integer)
      - `invoiceNumber` string — Public invoice number
      - `invoiceStatus` string — Invoice status: PAID, OPEN, or VOID
      - `monthlySubscriptionFee` number — Monthly subscription fee charged to this follower for the period
      - `previousHighWatermark` number — HIGH_WATERMARK only: previous cumulative profit peak before this billing period
      - `profitSharingAmount` number — Calculated profit sharing charge: followerProfit × profitSharingPercentage / 100
      - `profitSharingPercentage` number — Profit sharing percentage applied to this follower's profit
      - `totalAmount` number — Total charge for this follower: monthlySubscriptionFee + profitSharingAmount
    - `month` integer — Month number (1-12)
    - `totalCreditedNet` number — Net amount credited to the provider's balance this month
    - `totalEarnedGross` number — Total gross amount from all follower charges this month
    - `totalEarnedGrossPaid` number — Gross amount from PAID invoices this month
    - `totalEarnedGrossUnpaid` number — Gross amount from OPEN invoices this month
    - `totalEarnedGrossVoid` number — Gross amount from VOID (cancelled) invoices this month
    - `year` integer — Year (e.g. 2026)
  - `monthlySubscriptionFee` number — Configured monthly subscription fee charged to each follower
  - `profitSharingFee` number — Configured profit sharing percentage charged to each follower
  - `signalProviderId` string, uuid — UUID of the signal provider feature
  - `signalProviderName` string — Display name of the signal provider
  - `summary` EarningsSummaryDTO — Aggregated earnings summary across all billing periods
    - `activeFollowers` integer — Number of currently active (non-deleted) follower subscriptions
    - `metaCopierFeePercent` integer — Percentage MetaCopier retains as platform fee (e.g. 30 means provider receives 70%)
    - `totalCreditedNet` number — Net amount actually credited to the provider's project balance after MetaCopier fee deduction
    - `totalEarnedGross` number — Total gross amount from all follower charges across all invoice statuses, before MetaCopier fee deduction
    - `totalEarnedGrossPaid` number — Gross amount from PAID invoices only
    - `totalEarnedGrossUnpaid` number — Gross amount from OPEN (unpaid) invoices only
    - `totalEarnedGrossVoid` number — Gross amount from VOID (cancelled) invoices only
    - `totalFollowers` integer — Total number of unique follower accounts ever seen, including deleted ones

---

[API](https://skmtc.net/metacopier/apis/metacopier-api.md) · [All operations](https://skmtc.net/metacopier/apis/metacopier-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metacopier/metacopier-api/revisions/ff1699330afa/schema)