# Filecoin API
> Live on-chain data from the Filecoin network (FIL), the decentralized storage blockchain where miners are storage providers that pledge real disk capacity: an address's FIL balance, actor type and message count — and, for a storage provider, its raw and quality-adjusted storage power and sector size; storage providers ranked by power with each one's capacity, blocks mined and rewards; a tipset (Filecoin's block) with its height, time, block count and messages; and the chain height, total network storage power and number of active storage providers.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/filecoin-api/..."
```

## Pricing
- **Free** (Free) — 9,000 calls/Mo, 3 req/s
- **Basic** ($9/Mo) — 139,000 calls/Mo, 8 req/s
- **Pro** ($22/Mo) — 890,000 calls/Mo, 15 req/s
- **Scale** ($58/Mo) — 4,680,000 calls/Mo, 30 req/s

## Endpoints

### Network

#### `GET /v1/network` — Live chain height, total storage power and active providers

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/filecoin-api/v1/network"
```

**Response:**
```json
{
    "data": {
        "chain": "filecoin",
        "source": "Filecoin",
        "chain_time": "2026-06-10T13:59:00.000Z",
        "chain_height": 6093118,
        "native_token": "FIL",
        "active_storage_providers": 638,
        "network_storage_power_eib": 1.7058,
        "network_storage_power_pib": 1746.7079
    },
    "meta": {
        "timestamp": "2026-06-10T14:00:14.229Z",
        "request_id": "66a3b6b0-0dfa-43a3-9aaa-b90c4c7fb141"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```

### Address

#### `GET /v1/address` — An address FIL balance and (if a provider) storage power

**Parameters:**
- `address` (query, required, string) — Filecoin address (f0..f4) Example: `f02620`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/filecoin-api/v1/address?address=f02620"
```

**Response:**
```json
{
    "data": {
        "id": "f02620",
        "actor": "storageminer",
        "source": "Filecoin",
        "address": "f02620",
        "storage": {
            "owner": {
                "address": "f3wnmzhu5iln7shuawotkmbaejf6oabp7dits4t4p6zvwxeomqgewjpmp4ho4oyuxuga2gzwe7eu2nmw4prsjq",
                "balance": "4601544414673604093686"
            },
            "worker": {
                "address": "f3wnmzhu5iln7shuawotkmbaejf6oabp7dits4t4p6zvwxeomqgewjpmp4ho4oyuxuga2gzwe7eu2nmw4prsjq",
                "balance": "4601544414673604093686"
            },
            "raw_power_pib": 0.2939,
            "sector_size_gib": 32,
            "quality_power_pib": 0.953
        },
        "balance_fil": 12613.915603,
        "message_count": 46765,
        "created_height": 64,
        "last_seen_height": 6092988,
        "is_storage_provider": true
    },
    "meta": {
        "timestamp": "2026-06-10T14:00:15.373Z",
        "request_id": "b8122c85-8d8a-44f1-997b-d90888a27dfa"
    },
    "status": "ok",
    "message": "Address retrieved successfully",
    "success": true
}
```

### Providers

#### `GET /v1/providers` — Storage providers ranked by pledged power

**Parameters:**
- `limit` (query, optional, string) — Number of providers (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/filecoin-api/v1/providers?limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "height": 6093099,
        "source": "Filecoin",
        "providers": [
            {
                "rank": 1,
                "address": "f01889668",
                "blocks_mined": 122,
                "raw_power_pib": 14.5031,
                "quality_power_pib": 144.9341,
                "total_rewards_fil": 553.06313
            },
            {
                "rank": 2,
                "address": "f01315096",
                "blocks_mined": 116,
                "raw_power_pib": 12.424,
                "quality_power_pib": 124.2341,
                "total_rewards_fil": 539.784024
            },
            {
                "rank": 3,
                "address": "f0870558",
                "blocks_mined": 102,
                "raw_power_pib": 11.6766,
                "quality_power_pib": 116.7369,
                "total_rewards_fil": 455.7169
            },
            {
                "rank": 4,
                "address": "f01518369",
                "blocks_mined": 101,
                "raw_power_pib": 11.6363,
                "quality_power_pib": 116.2566,
                "total_rewards_fil": 451.29326
            },
            {
                "rank": 5,
                "address": "f03055005",
                "blocks_mined": 107,
                "raw_power_pib": 11.3914,
                "quality_power_pib": 113.8968,
                "total_rewards_fil": 491.122049
            },
            {
                "rank": 6
…(truncated, see openapi.json for full schema)
```

### Tipset

#### `GET /v1/tipset` — A tipset height, time, blocks and messages

**Parameters:**
- `height` (query, optional, string) — Tipset height or latest Example: `latest`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/filecoin-api/v1/tipset?height=latest"
```

**Response:**
```json
{
    "data": {
        "height": 6093119,
        "miners": [
            "f03253411",
            "f03559187",
            "f03166677",
            "f03540147",
            "f03526491"
        ],
        "source": "Filecoin",
        "timestamp": "2026-06-10T13:59:30.000Z",
        "block_count": 5,
        "message_count": 23
    },
    "meta": {
        "timestamp": "2026-06-10T14:00:16.328Z",
        "request_id": "dd3ffdd2-944e-4146-acf6-1c23964e0527"
    },
    "status": "ok",
    "message": "Tipset retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata and endpoint catalog

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/filecoin-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Filfox Filecoin explorer API (filfox.info, live)",
        "service": "filecoin-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/tipset": "A tipset's height, time, blocks and messages (height=latest|N).",
            "GET /v1/address": "An address's FIL balance and (if a provider) storage power (address=f02620).",
            "GET /v1/network": "Chain height, total network storage power and active providers.",
            "GET /v1/providers": "Storage providers ranked by pledged power (limit=20)."
        },
        "description": "Live on-chain data from the Filecoin network (FIL), the decentralized storage blockchain where miners are storage providers that pledge real disk capacity, via the public Filfox explorer. The address endpoint returns an address's FIL balance, actor type, message count and — for a storage provider — its raw and quality-adjusted storage power and sector size; the providers endpoint ranks storage providers by power with each one's capacity, blocks mined and rewards; the tipset endpoint returns a tipset (Filecoin's block) with its height, time, block count and messages; the network endpoint returns the chain height, total network storage power and number of active storage providers. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, Celestia, Cosmos and EVM on-chain APIs and from price feeds — this is Filecoin's own FIL account state, storage-provider 
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/filecoin-api
OpenAPI spec: https://www.oanor.com/api/filecoin-api/openapi.json