Day, week or month lines of an account: fees, signed extrinsics, transfer flow, income
https://api.bittensor.ai/api/v2/accounts/{address}/daily- Status
- Beta
- Auth
- API key or OAuth access token
- Scope
data:read- Rate limit
plan
Per UTC day, week.
Full description
Per UTC day, week (Monday) or month (interval), what the account did: the fees it paid (payer side: tx_count, fee_tao_rao, fee_alpha by subnet, routine_fee_tao_rao), the extrinsics it signed (signer side: signed_count, routine calls by name), its TAO and stake transfers with other accounts (tao_in_rao, tao_out_rao, stake_in_tao_rao, stake_out_tao_rao, net_flow_tao_rao) and its income (income_alpha by subnet, income_tao_rao at each day's close). The payer and the signer differ under a proxy or a sponsoring hotkey owner, so tx_count and signed_count are counted apart. Income follows the income surfaces' rules: only what was credited to the account (claimable root dividends are never income). routine_fee_tao_rao is 0 today: the runtime charges routine calls (weights, axon) no fee.
Sparse: a period with nothing to report is absent; data is newest period_start first. The window is from_day..to_day (inclusive UTC days; default the 7 days ending today, the open day included), widened to whole periods; a to_day after today is served through today. The span is at most 366 days with interval=day and 3660 with week / month, and an answer holds at most 2000 rows (accounts x periods): above either a 400 RANGE_TOO_LARGE. Today's numbers are read live (has_open_day) and grow; a period is complete once it has ended and both sides cover it (meta.coverage). meta.accounts states each account's last activity overall and per group (transfer, staking, trades, income), whatever the window. An account the data source has never seen is served with no rows and null activity, never a 404.
Cached as tip while the window reaches today or a row is not final; otherwise for 5 minutes (the rows are final, the last activity in meta is not). Errors: INVALID_ADDRESS, INVALID_FORMAT. Errors are application/problem+json: INVALID_DAY, INVALID_RANGE, INVALID_INTERVAL, RANGE_TOO_LARGE, UNKNOWN_PARAMETER, SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503: this deployment's data source is not configured or does not have the route's data yet), SERVICE_UNAVAILABLE (503).
format=csv (an accounting export): the same rows as the JSON answer, in the same order, as text/csv (RFC 4180, UTF-8, CRLF line ends, one header line) with Content-Disposition: attachment; filename=account-daily-<ss58>-<interval>-<from_day>-<to_day>.csv (the window served). The same window rules, caps and caching as the JSON. CSV fields, in order: address (SS58), address_hex, period, period_start, period_end, complete, has_open_day (true / false), active_days, tx_count, fee_tao, fee_tao_rao, fee_alpha, fee_alpha_rao, routine_fee_tao, routine_fee_tao_rao, signed_count, routine, tao_in, tao_in_rao, tao_out, tao_out_rao, stake_in_tao, stake_in_tao_rao, stake_out_tao, stake_out_tao_rao, net_flow_tao, net_flow_tao_rao, income_alpha, income_alpha_rao, income_tao, income_tao_rao. Each amount comes twice: as an exact decimal of whole TAO with 9 places (fee_tao 0.000125000; net_flow_tao signed) and as the JSON member's integer rao (fee_tao_rao 125000). The by-subnet lists are netuid:amount pairs joined by ;: fee_alpha / income_alpha in decimal alpha of that subnet (TAO on root, netuid 0), fee_alpha_rao / income_alpha_rao in its rao; routine is call:count pairs. An empty cell is a null (income_tao when a subnet had no price) or an empty list. The address fields are the account's own (this route serves one account). Errors stay application/problem+json.
Beta: this route may change with one release's notice in the v2 changelog; additive changes need none (x-stability: beta).
Path parameters
- addresspath, required· string
The account (any account: coldkey or hotkey): SS58, or 0x + 64 hex.
Query parameters
- from_dayquery· string (date)
The first UTC day,
YYYY-MM-DD, inclusive (widened to its week's Monday / month's first day). Default: 6 days beforeto_day. Afterto_day(default today) is a 400INVALID_RANGE; anything else a 400INVALID_DAY.- Format: date, YYYY-MM-DD
- to_dayquery· string (date)
The last UTC day,
YYYY-MM-DD, inclusive. Default: today (UTC), the open day; a later day is served through today. Anything else is a 400INVALID_DAY.- Format: date, YYYY-MM-DD
- intervalquery· enum · one of day, week, month · default day
day(the default),week(Monday to Sunday, UTC) ormonth(UTC). Anything else: 400INVALID_INTERVAL.- formatquery· enum · one of json, csv · default json
json(the default):{data, meta}.csv: the same rows as an accounting export,text/csvas an attachment (the fields in the route's description). Anything else: 400INVALID_FORMAT.
Response
data is a list of objects with these fields. Amounts are integer strings in their base unit, and null means unknown, never zero (see Units and formats). meta.at names the block the answer was read at.
The periods with anything to report (a period with nothing is absent), newest period_start first, then by account; [] when none.
- addressobject · can be null
The account, as
{ss58, hex}. Null on anaggregate_onlyanswer (each row sums the accounts).2 fields in address
- ss58string
The account, SS58 (prefix 42).
- Format: SS58 address
- hexstring
The same 32-byte account id, 0x + 64 lower-case hex (the public key).
- Format: 32-byte hex: 0x and 64 hex digits
- periodenum
The interval asked for:
day,week(Monday UTC) ormonth(UTC).- One of:
day,week,month - period_startstring (date)
The period's first UTC day.
- Format: date, YYYY-MM-DD
- period_endstring (date)
The period's last UTC day (a week's Sunday, a month's last day), even when after today.
- Format: date, YYYY-MM-DD
- completeboolean
The period has ended and every day of it is covered on both sides (fees / flow and income:
meta.coverage). False for a period holding today and for one reaching before a side'sclosed_from_day.- has_open_dayboolean
The period includes today (UTC), read live up to
meta.tip_height: its numbers still grow.- active_daysinteger · unit count
Days of the period with anything to report (a fee, a signed extrinsic, a transfer, income).
- tx_countinteger · unit count
Extrinsics whose fee the account paid. PAYER side: the account paid the fee (
TransactionFeePaid.who: the signer, or a proxy's real account / a sponsoring hotkey owner).- fee_tao_raostring · unit rao (÷1e9)
Those fees in TAO (the actual fee, tip included), rao of TAO. PAYER side: the account paid the fee (
TransactionFeePaid.who: the signer, or a proxy's real account / a sponsoring hotkey owner).- Format: whole number, as a string
- fee_alphaarray of objects
Fees paid in alpha (
TransactionFeePaidWithAlpha), by subnet, ascending netuid;[]when none. PAYER side: the account paid the fee (TransactionFeePaid.who: the signer, or a proxy's real account / a sponsoring hotkey owner).2 fields in fee_alpha (each item)
- netuidinteger · unit id
The subnet (0 = root, whose amounts are TAO).
- alpha_raostring · unit alpha_rao (÷1e9)
The amount on that subnet, rao of its alpha (rao of TAO on root).
- Format: whole number, as a string
- routine_fee_tao_raostring · unit rao (÷1e9)
The part of
fee_tao_raopaid for routine calls (weights, commits / reveals, axon / prometheus), rao of TAO. 0 today: the runtime charges those calls no fee. PAYER side: the account paid the fee (TransactionFeePaid.who: the signer, or a proxy's real account / a sponsoring hotkey owner).- Format: whole number, as a string
- signed_countinteger · unit count
SIGNER side: extrinsics the account signed, whoever paid their fee.
- routinearray of objects
SIGNER side: the routine calls among them (weights, commits / reveals, axon / prometheus), by call, ascending
call; the extrinsic's own call (a proxied one counts as the proxy call);[]when none.2 fields in routine (each item)
- callstring
The call,
Pallet.call_name(e.g.SubtensorModule.set_weights).- countinteger · unit count
How many the account signed in the period.
- tao_in_raostring · unit rao (÷1e9)
TAO received by
Balances.Transfer, rao of TAO. Transfers between distinct accounts only (a transfer to itself is excluded).- Format: whole number, as a string
- tao_out_raostring · unit rao (÷1e9)
TAO sent by
Balances.Transfer, rao of TAO. Transfers between distinct accounts only (a transfer to itself is excluded).- Format: whole number, as a string
- stake_in_tao_raostring · unit rao (÷1e9)
Stake received from other coldkeys (
StakeTransferredto it), at its TAO value at the transfer, rao of TAO.- Format: whole number, as a string
- stake_out_tao_raostring · unit rao (÷1e9)
Stake sent to other coldkeys (
StakeTransferredfrom it), at its TAO value at the transfer, rao of TAO.- Format: whole number, as a string
- net_flow_tao_raostring · unit rao (÷1e9)
tao_in - tao_out + stake_in - stake_out, rao of TAO, signed (fees and income are not in it).- Format: whole number, as a string · can be negative
- income_alphaarray of objects
Income credited to the account (the coldkey credited: emission minted to it), by subnet, ascending netuid (root's in TAO);
[]when none. Claimable root dividends are never income (only what was credited counts, as on the income surfaces).2 fields in income_alpha (each item)
- netuidinteger · unit id
The subnet (0 = root, whose amounts are TAO).
- alpha_raostring · unit alpha_rao (÷1e9)
The amount on that subnet, rao of its alpha (rao of TAO on root).
- Format: whole number, as a string
- income_tao_raostring · unit rao (÷1e9) · can be null
That income in TAO: each day's alpha at that day's closing pool price (the open day at
meta.coverage.income.open_through_height; root 1:1), floored per subnet-day and summed, rao of TAO. Null when a subnet of the period had no price.- Format: whole number, as a string
Response headers
11 headers: Content-Disposition, ETag, Cache-Control, CDN-Cache-Control, X-BTAI-Stale, X-BTAI-Stale-As-Of, RateLimit-Policy, RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
- Content-Disposition
With
format=csv:attachment; filename=account-daily-<ss58>-<interval>-<from_day>-<to_day>.csv.- ETag
Strong validator of this answer. Send it back as
If-None-Match: an unchanged answer is a 304 Not Modified without a body. A settled answer's validator leaves the chain head out, so it stays valid as the head moves.- Cache-Control
One of three classes: settled
public, max-age=3600, stale-while-revalidate=86400(pinned to a block that cannot move), slowpublic, max-age=300, stale-while-revalidate=600(state that moves in minutes or days) or tippublic, max-age=6, stale-while-revalidate=12(follows the chain head); the label routes are cached until the next nightly copy (public, max-age=<seconds>, stale-while-revalidate=60). Neverimmutable.no-storeon an earlier answer served because the data source failed (X-BTAI-Stale).- CDN-Cache-Control
The same class for shared caches (RFC 9213; browsers ignore it): settled 24 h, slow 300 s, tip 6 s, each with
stale-while-revalidateandstale-if-error;no-storewithX-BTAI-Stale.- X-BTAI-Stale
Present only when the data source failed to answer (it timed out or was unavailable) and an earlier answer to the same request is served instead of a 503 (stale if error, RFC 5861). Then
if-error, withX-BTAI-Stale-As-Of,Age(its seconds since then) andWarning: 110 - "Response is Stale", andCache-Control: no-store: the answer is never kept as fresh, and a later request reads again. Prices and quotes are never served this way.- X-BTAI-Stale-As-Of
With
X-BTAI-Stale: when the earlier answer served was produced, an RFC 3339 UTC time (2026-10-21T12:00:00Z).- RateLimit-Policy
The tier's request quota of the current window (IETF draft), e.g.
"tier";q=600.- RateLimit
Requests left in the current window and the seconds until it resets (IETF draft), e.g.
"tier";r=597;t=42.- X-RateLimit-Limit
The tier's request quota of the current window.
- X-RateLimit-Remaining
Requests left in the current window.
- X-RateLimit-Reset
When the current window resets, Unix seconds.
Status codes
200 · 304 · 400 · 401 · 402 · 403 · 404 · 429 · 500 · 502 · 503
304 Not Modified: the If-None-Match validator still matches; no body.
Error codes
The codes this endpoint can return. Each links to what it means and what to do.
- ADDRESS_NOT_IN_PLAN_SCOPE
- AMBIGUOUS_CREDENTIALS
- BAD_GATEWAY
- BILLING_UNAVAILABLE
- BUDGET_EXCEEDED
- CONCURRENCY_LIMIT
- INSUFFICIENT_PERMISSIONS
- INTERNAL_ERROR
- INVALID_ADDRESS
- INVALID_DAY
- INVALID_FORMAT
- INVALID_INTERVAL
- INVALID_RANGE
- PAYMENT_REQUIRED
- RANGE_TOO_LARGE
- RATE_LIMITED
- REPEATED_PARAMETER
- SERVICE_UNAVAILABLE
- SOURCE_BUSY
- SOURCE_NOT_READY
- SOURCE_TIMEOUT
- UNAUTHORIZED
- UNKNOWN_PARAMETER
- VALIDATION_ERROR
From the API's published specification, version 1.165.0.