Analytics API

Aggregate numbers for dashboards, and the AE exchange rates every fiat figure in the API is built on. Most of these endpoints return bare arrays or scalars rather than the paginated envelope.

All paths are relative to https://api.superhero.com. Reads need no authentication.

Endpoints

Posting activity has its own set under /api/posts/analytics* and referral activity under /api/bcl-affiliation/analytics*. See Posts and Invitations & Affiliations.

Date parameters are snake_case start_date / end_date in YYYY-MM-DD format.

GET /api/analytics/past-24-hours

Returns one object with seven fields:

curl -s "https://api.superhero.com/api/analytics/past-24-hours"

An optional address scopes every field to one account: the transaction aggregates filter on address, total_tokens counts tokens that account created, and the market-cap sum is restricted to tokens with that creator_address.

total_tokens is cumulative; the 24-hour creation count is total_created_tokens.

total_market_cap_sum and GET /api/analytics/total-market-cap measure different quantities on different scales:

Both values arrive as JSON strings because they are decimal columns; total_market_cap_sum is not a big integer.

Daily series

Four endpoints return a bare JSON array with one element per day.

GET /api/analytics/daily-trade-volume

Filter with token_address for one market or account_address for one trader.

curl -s "https://api.superhero.com/api/analytics/daily-trade-volume?start_date=2026-08-01&end_date=2026-09-01"

GET /api/analytics/daily-unique-active-users

date and active_users (number). Takes token_address to scope to one market.

GET /api/analytics/daily-created-tokens-count

date in YYYY-MM-DD and count (number).

GET /api/analytics/daily-market-cap-sum

date (YYYY-MM-DD) and sum, one element per day, ascending. sum is in AE, not aettos. It is the last-trade-per-token sum described under past-24-hours, computed at each day's end. Do not divide by 1e18.

• The range is clamped to 365 days; a wider start_date is moved forward, not rejected.
• With neither date, start_date and end_date both default to today, so you get a single row.
• Each day is an aggregate query; a full year is 365 of them. Cached for 20 seconds.
• token_sale_addresses is accepted but the series is always platform-wide. For a per-token series use GET /api/tokens/{address}/history.

Totals

curl -s "https://api.superhero.com/api/analytics/total-created-tokens"

total-market-cap is the one market-cap figure in the API in aettos. Divide by 1e18. sum_data is the same aettos value multiplied through the AE fiat rates, so every currency key is on the aettos scale too.

total-unique-users accepts token_sale_addresses (at most 100; more is a 400) to restrict the count to traders of those tokens. Unknown addresses are dropped; if none resolves to a token the answer is { "total_users": 0 }. Cached for 20 seconds.

total-created-tokens is scoped to the current factory, so it does not match total_tokens from past-24-hours, which counts every token.

AE price and fiat rates

GET /api/coins/aeternity/rates returns a flat map of currency code to rate:

{ "usd": 0.0312, "eur": 0.0287, "aud": 0.0471, "brl": 0.1683,
  "cad": 0.0428, "chf": 0.0249, "gbp": 0.0243, "xau": 0.0000094 }

curl -s "https://api.superhero.com/api/coins/aeternity/rates"

The map has exactly eight keys (usd, eur, aud, brl, cad, chf, gbp, xau), one for each convertTo currency other than ae. A response either has all eight or is replaced by the last known good snapshot. xau is troy ounces of gold.

GET /api/coins/aeternity/history gives the AE price series as [timestamp_ms, price] pairs:

curl -s "https://api.superhero.com/api/coins/aeternity/history?currency=usd&interval=daily&days=90"

GET /api/coins/aeternity/market-data?currency=usd returns the broader market picture in camelCase, the only camelCase response body in the API:

id · symbol · name · lastUpdated
currentPrice · high24h · low24h
priceChange24h · priceChangePercentage24h
marketCap · marketCapChange24h · marketCapChangePercentage24h
fullyDilutedValuation
circulatingSupply · totalSupply · maxSupply · totalVolume
ath · athChangePercentage · athDate
atl · atlChangePercentage · atlDate
roi
dataSource · isFallback

Every figure is denominated in currency, default usd. dataSource is coingecko or fallback, and isFallback says the server is serving the last known good snapshot because the upstream was unreachable. Check them before treating the numbers as current.

GET /api/analytics and GET /api/analytics/summary

GET /api/analytics returns an array, one element per day, of the same seven fields as past-24-hours. Rows read from the cached table carry an extra id; rows computed live (the address-scoped path) do not. Do not key on id.

Without address the rows come from the cached daily table. With address they are computed live, so an address-scoped call is slower and always current.

GET /api/analytics/summary returns { "total_unique_accounts": <n> } for the range. This is a true distinct count over the whole range, not a sum of per-day distincts. Both dates are optional; omitting them makes it all-time.

Freshness

GET /api/analytics/challenge

A per-account, per-day activity grid for comparing a small set of traders over a period.

curl -s "https://api.superhero.com/api/analytics/challenge?addresses=ak_FIRST_ADDRESS,ak_SECOND_ADDRESS&start_date=2026-09-01&end_date=2026-09-14"

Returns a flat array with one row per address per day, zero-filled: every address gets a row for every day in the range:

GET /api/analytics/challenge/preview and GET /api/analytics/preview are server-rendered HTML dashboards, not JSON.

Related

• API Conventions: the units rule and the non-envelope response shapes
• Tokens API: per-token history, the fine-grained counterpart to these aggregates
• Accounts API: per-account portfolio history and trading statistics
• Invitations & Affiliations: the referral analytics endpoints