---
title: "Get covered follower costs"
method: GET
path: "/rest/api/v1/signals/{signalProviderId}/followerCosts"
tags: ["Signal API"]
---

# Get covered follower costs

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

## Request

- Base URL: `https://api.metacopier.io`
- URL: `https://api.metacopier.io/rest/api/v1/signals/{signalProviderId}/followerCosts`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/metacopier/apis/metacopier-api/docs/rest/api/v1/signals/:signalProviderId/followerCosts/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns what the signal provider paid for each of its followers, per month. Only applies when the signal provider covers follower costs; otherwise the result is empty. Followers that cost nothing, for example because they exceed the per-project cap, are not listed. If month and year are not provided, all months are returned.

## Path parameters

- `signalProviderId` string, uuid, required

## Query parameters

- `month` integer
- `year` integer

## Response `200`

OK

- SignalFollowerCostDTO: Follower costs covered by a signal provider
  - `coverFollowerCosts` boolean: Whether this signal provider currently covers the costs of its followers. If false, no costs are reported.
  - `currency` string: Currency of all monetary amounts
  - `months` MonthlyFollowerCostDTO[]: Per-month breakdown, oldest month first
    - `coveredFollowers` integer: Number of followers the provider paid for in this month
    - `current` boolean: True for the running month: the amount is month-to-date and not yet invoiced
    - `followers` FollowerCostDetailDTO[]: One entry per covered follower. Followers with no cost are not listed.
      - `accountNumber` string: Login account number of the follower account
      - `broker` string: Broker server of the follower account
      - `cost` number: Amount the provider paid for this follower in this month
      - `daysActive` integer: Days the follower subscription was active during this month
      - `email` string: Email of the follower, obfuscated or hidden depending on the signal's visibility settings
      - `followerAccountId` string, uuid: UUID of the follower account
    - `month` integer: Month of the billing period (1-12)
    - `pricePerAccountPerDay` number: Rate charged to the provider per covered follower account and day
    - `totalCost` number: Total covered follower costs of this month
    - `year` integer: Year of the billing period
  - `signalProviderId` string, uuid: UUID of the signal provider feature
  - `signalProviderName` string: Display name of the signal provider
  - `totalCost` number: Total covered follower costs across all reported months

## Changes

- **2026-09-06** `b04aace08df3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metacopier/apis/metacopier-api/changes/rest/api/v1/signals/:signalProviderId/followerCosts/get.md)

---

[API](https://skmtc.dev/metacopier/apis/metacopier-api.md) - [All operations](https://skmtc.dev/metacopier/apis/metacopier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacopier/apis/metacopier-api/revisions/cbf3e7810fc2?raw)