FMFansMetric API

Earnings

List All Earnings

Returns the account's per-transaction earnings feed across all revenue streams combined — subscriptions, tips, PPV post purchases, paid messages, stream earnings. One row per payment. Filter to a single stream with type; narrow tips to a single surface with tips_source. Requires permission api_earnings_list.

https://public-api.buffmetrics.com
GET/v1/{account_id}/earnings
Bearer

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

  • start_datestring

    Lower bound on createdAt. Default 2 years ago, UTC. Format YYYY-MM-DD HH:MM:SS or ISO 8601 (T is normalized to a space).

  • end_datestring

    Optional upper bound on createdAt. Same format as start_date.

  • markerstring

    Pagination cursor (unix seconds). Omit on the first page; pass the previous response's nextMarker for subsequent pages.

  • typestring

    Revenue-stream filter. Values: subscribes, tips, post, chat_messages, stream. Omit for everything.

  • tips_sourcestring

    Only meaningful when type=tips. Narrows to a single surface. Values: profile, post_all, chat, stream, story. Forwarded upstream as tipsSource.

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

Response

200
{
"data":{
"list":[
0:{
"id":"fd1d0844b7129594ba045a5cf8045fc5"
"amount":19
"vatAmount":0
"taxAmount":0
"mediaTaxAmount":0
"net":15.2
"fee":3.8
"currency":"USD"
"createdAt":"2026-05-28T12:54:47+00:00"
"description":"Payment for message from <a href="https://onlyfans.com/u570110444">Kbood</a>"
"status":"loading"
"payoutPendingDays":7
"user":{
"id":570110444
"name":"Kbood"
"username":"u570110444"
"displayName":"Kbood"
"view":"t"
"isVerified":false
"isDeleted":false
"isActive":true
"avatar":null
"avatarThumbs":null
}
}
]
"marker":1779973132
"hasMore":true
"nextMarker":1779966690
}
"_pagination":{
"next_page":"/v1/523213896/earnings?start_date=2025-09-17%2004%3A23%3A50&marker=1779966690"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Get Earnings Chart

Next

Top Highlights