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.fansmetric.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.

Response Fields

data.statstring
Echoes the requested stat.
data.statHumanstring
Human-readable label.
data.descriptionstring
One-line explanation of the stat.
data.granularitystring
Resolved bucket size.
data.chartLabels[]array
RFC 3339 UTC timestamps at the start of each current-window bucket.
data.chartValues[]array
Per-bucket values for the current window. Empty buckets are zero-filled.
data.chartValuesPrevious[]array
Per-bucket values for the previous window (same length, aligned index-by-index with chartValues).
data.currentnumber
Summary for the current window. Sum of chartValues for most stats; last value for rolling stats (monthlychatearnings, monthlychattingfans, chatafv).
data.previousnumber
Summary for the previous window (same rule as current).
data.changenumber
(current − previous) / previous as a decimal. 0 when previous is 0.
data.symbolstring
$, %, or empty.
data.valueIsIntegerboolean
Render hint.
data.symbolFirstboolean
Render hint.
data.positiveIsGoodboolean
Render hint.
data.fromstring
Bucket-aligned start of the current window (RFC 3339 UTC). May be snapped to the bucket boundary — e.g. 2026-07-15T14:32:00Z at day becomes 2026-07-15T00:00:00Z.
data.tostring
Bucket-aligned end of the current window.
data.revenueTypestring
Echoes the effective revenue variant.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data.stat	string	Echoes the requested stat.
data.statHuman	string	Human-readable label.
data.description	string	One-line explanation of the stat.
data.granularity	string	Resolved bucket size.
data.chartLabels[]	array	RFC 3339 UTC timestamps at the start of each current-window bucket.
data.chartValues[]	array	Per-bucket values for the current window. Empty buckets are zero-filled.
data.chartValuesPrevious[]	array	Per-bucket values for the previous window (same length, aligned index-by-index with `chartValues`).
data.current	number	Summary for the current window. Sum of `chartValues` for most stats; last value for rolling stats (`monthlychatearnings`, `monthlychattingfans`, `chatafv`).
data.previous	number	Summary for the previous window (same rule as `current`).
data.change	number	`(current − previous) / previous` as a decimal. `0` when `previous` is 0.
data.symbol	string	`$`, `%`, or empty.
data.valueIsInteger	boolean	Render hint.
data.symbolFirst	boolean	Render hint.
data.positiveIsGood	boolean	Render hint.
data.from	string	Bucket-aligned start of the current window (RFC 3339 UTC). May be snapped to the bucket boundary — e.g. `2026-07-15T14:32:00Z` at `day` becomes `2026-07-15T00:00:00Z`.
data.to	string	Bucket-aligned end of the current window.
data.revenueType	string	Echoes the effective revenue variant.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/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