Get the daily on-chain activity of a chain
/v1/chains/{chain}/activityCall this for six daily series of a chain: transactions, active accounts, new accounts, the average gas price in gwei, the transaction fees in the chain's coin and the block utilization in percent. days is 30, 90 or 365, 90 by default. Ethereum (eip155:1) and Arc (eip155:5042) have all six, each from its explorer's Blockscout stats service. Monad (eip155:143) has no stats service, so Sona counts its blocks itself and answers three series, txs, gas_price_gwei and utilization_pct, with the coverage code chain_activity_from_blocks: the count leaves out Monad's system transactions, and blocks say nothing of accounts, so active_accounts, new_accounts and the fees are missing. A Monad block's gas used is the sum of its transactions' gas limits, which Monad charges, so Monad's utilization_pct is the share of each block the transactions reserved, not the gas they executed. Monad's days start the day after Sona began counting. The last item is the current UTC day. Read every hour. Sona keeps an answer for 30 minutes.
Path parameters
| Name | Type | Description |
|---|---|---|
chainRequired | string | The chain, as a CAIP-2 chain ID. Ethereum, |
Query parameters
| Name | Type | Description |
|---|---|---|
days | stringDefault 90 | How many days of history: |
Response
The answer, wrapped in the {data, meta, links} envelope.
| Field | Type | Description |
|---|---|---|
| chain | string | A chain ID in the CAIP-2 format |
| coverage | array of strings | The codes of the limits that apply to this answer, in a fixed order. It is empty when none applies. |
| kind | string | chain_activity |
| series | array of objects | The series in a fixed order, six on Ethereum and Arc and three on Monad ( |
Cost
1 credit. The time limit is 5 seconds.
Errors
| Status | Code |
|---|---|
| 400 | invalid_idinvalid_query |
| 404 | unsupported_chain |
| 429 | rate_limitedcredits_exhausted |
| 500 | internal |
| 503 | upstream_unavailable |
| 504 | deadline_exceeded |
400 invalid_id, 400 invalid_query for a days that is not listed or another query key, 404 unsupported_chain, 429 rate_limited or credits_exhausted, 503 upstream_unavailable before the first refresh, and 504 deadline_exceeded.