---
title: WGO On-chain Endpoint
description: Reference for daily BTC and ETH on-chain fundamentals.
---

# On-chain endpoint

```http
GET /api/wgo/v1/assets/{asset}/onchain
```

The endpoint returns daily network activity, supply, fees, and exchange-flow metrics
for BTC or ETH.

| Parameter | Type | Default | Constraint |
| --- | --- | --- | --- |
| `asset` | path string | — | `BTC` or `ETH` |
| `start` | query date | omitted | Inclusive `YYYY-MM-DD` |
| `end` | query date | omitted | Inclusive `YYYY-MM-DD` |
| `limit` | query integer | `365` | 1–5000 |

Rows are ordered by `metric_date` descending.

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/wgo/v1/assets/BTC/onchain?limit=30"
```

## Response

```json
{
  "asset": "BTC",
  "count": 1,
  "data": [
    {
      "asset": "BTC",
      "metric_date": "2026-08-22",
      "active_address_count": 634723,
      "address_with_balance_count": 56745653,
      "block_count": 148,
      "transaction_count": 709046,
      "transfer_count": 1037706,
      "fees_native": "3.0372742",
      "exchange_inflow_native": "19439.57718069",
      "exchange_outflow_native": "16684.13543387",
      "exchange_netflow_native": "2755.44174682",
      "exchange_supply_native": "2714042.92514466",
      "circulating_supply_native": "20073782.38473258",
      "issuance_native": "462.5",
      "hash_rate": "937551968.6517191285701026202708717412007967968",
      "source_eod_completed_at": "2026-08-23T02:57:28+00:00",
      "has_flash_data": true,
      "synced_at": "2026-08-23T14:45:10.215968+00:00"
    }
  ]
}
```

The values above illustrate the response shape.

## Field groups

| Group | Fields |
| --- | --- |
| Network activity | `active_address_count`, `address_with_balance_count`, `block_count`, `transaction_count`, `transfer_count` |
| Native-asset economics | `fees_native`, `issuance_native`, `circulating_supply_native` |
| Exchange balance flow | `exchange_inflow_native`, `exchange_outflow_native`, `exchange_netflow_native`, `exchange_supply_native` |
| Network security | `hash_rate` when applicable to the asset |
| Data state | `source_eod_completed_at`, `has_flash_data`, `synced_at` |

Fields ending in `_native` use the base asset, such as BTC or ETH, not US dollars.
Metrics unavailable for a network or date are returned as `null`.

::: warning Provisional observations
When `has_flash_data` is `true`, at least one daily metric is provisional. Store the
date as revisable and allow a later response to replace it.
:::