Chat

Chat Chart

Returns a time-series for one chat stat over the requested window, with per-bucket values for both the current window and the previous window (same length, immediately before). Use for line/bar charts. For the full 11-stat headline card in a single call, use Chat Overview. Requires permission api_chat_read_chart.

https://public-api.buffmetrics.com

GET/v1/{account_id}/chat/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

stat*string
Which stat to chart. One of outgoingmessages, monthlychattingfans, monthlychatearnings, chatafv, chatearnings, averagetip, averagemessage, tips, messages, tipscount, messagescount.
fromstring
Window start (UTC). Default 30 days ago. Accepts ISO 8601 or relative shorthand (-30days).
tostring
Window end (UTC). Default now. Must be after from.
granularitystring
Bucket size — hour, day, week, or month. Defaults: hour under a day, month over four months, otherwise day. monthlychatearnings, monthlychattingfans, and chatafv are day-only; other granularities are treated as day on those stats.
revenue_typestring
net (default) or gross. Same semantics as Chat Overview. Ignored for count stats and for always-net rolling stats.

curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/chat/chart?stat=sample_stat&from=sample_from&to=sample_to" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"stat":"chatearnings"
"statHuman":"Chat Earnings"
"description":"Earnings from tips and PPV message unlocks, bucketed."
"granularity":"day"
"chartLabels":[0:"2026-08-04T00:00:00Z"
1:"2026-08-05T00:00:00Z"
2:"2026-08-06T00:00:00Z"
3:"2026-08-07T00:00:00Z"
4:"2026-08-08T00:00:00Z"
5:"2026-08-09T00:00:00Z"
6:"2026-08-10T00:00:00Z"
]
"chartValues":[0:11482.1
1:10940.32
2:9821.05
3:12211.78
4:13045.2
5:8791.44
6:10990
]
"chartValuesPrevious":[0:9821.32
1:10012.55
2:10488.1
3:11201.44
4:11890.02
5:9020.1
6:9975.6
]
"current":77281.89
"previous":72409.13
"change":0.0673
"symbol":"$"
"valueIsInteger":false
"symbolFirst":true
"positiveIsGood":true
"from":"2026-08-04T00:00:00Z"
"to":"2026-08-11T00:00:00Z"
"revenueType":"net"
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Chat Overview

List Chatters