Earnings

Get Earnings Chart

Returns the per-source earnings timeseries that backs the OnlyFans **Statements → Earnings** page — one $ series (chartAmount), one transaction-count series (chartCount), net + gross totals, and OF's percent-change delta vs the previous equal-length window. Bucket granularity (daily vs monthly) is chosen by OnlyFans based on window length. Requires permission api_earnings_read_chart.

https://public-api.buffmetrics.com

GET/v1/{account_id}/earnings/chart

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.

Query Parameters

bystring
Revenue source. One of total (default), subscribes, tips, post, chat_messages, stream. Vocabulary matches the type parameter on [/v1/{account_id}/earnings](/api-reference/earnings/list).
start_datestring
Window start. Default 2 years ago, UTC. YYYY-MM-DD HH:MM:SS or ISO 8601 (the T separator is normalized to a space). To pull a full lifetime chart, pass the startDate from /me/start-date.
end_datestring
Window end. Default end of today, UTC. Same format as start_date.

curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/earnings/chart?by=sample_by&start_date=sample_start_date&end_date=sample_end_date" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"chartAmount":[0:{"date":"2025-09-01T00:00:00+00:00"
"count":10040
}
1:{"date":"2025-10-01T00:00:00+00:00"
"count":152856.81
}
]
"chartCount":[0:{"date":"2025-09-01T00:00:00+00:00"
"count":395
}
1:{"date":"2025-10-01T00:00:00+00:00"
"count":5286
}
]
"total":1404729.68
"gross":1754794.68
"delta":100
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Earnings Overview

List All Earnings