Documentation

Where the data comes from and how to use it.

Data Sources

Datasets are rebuilt daily from these sources. Each asset declares its source in the asset code.

Lily
Chain data on BigQuery: power, sectors, rewards, fees, and messages.
Filecoin JSON-RPC
Current storage provider state and PDP registry reads, from Glif, Chain.love, and ChainUp nodes.
RIBA chain archive
Daily eth_getBlockReceipts dumps from chain.data.riba.plus, the source of all FEVM event logs.
Filecoin Services
Contract deployments, plus Blockscout ABIs, to decode Filecoin Pay, Warm Storage, and PDP events.
PDP provider registry
Provider names, status, and endorsements.
CoinCodex
Daily FIL price, volume, and market cap.
Open Source Observer
Public goods funding deployments.

Using Datasets

Every dataset in the catalog is published daily as a Parquet file. Any Parquet-capable tool can read it directly from: 

https://data.filecoindataportal.xyz/<dataset>.parquet

DuckDB

Run it in the DuckDB CLI or in the browser with SQL Workbench. 

select date, onboarded_pibs, raw_power_pibs
from 'https://data.filecoindataportal.xyz/daily_network_metrics.parquet'
order by date desc
limit 7;

Python

import polars as pl

df = pl.read_parquet(
    "https://data.filecoindataportal.xyz/storage_providers.parquet"
)

JavaScript

daily_network_metrics is also published as JSON for dashboards. 

const url = "https://data.filecoindataportal.xyz/daily_network_metrics.json"
const rows = await (await fetch(url)).json()

AI agents

Point your agent to SKILL.md or llms.txt to find, query, and chart the datasets.

Dashboards

Filecoin In Numbers and Revenue are built on the same datasets. See the source code.

Filfox
Chain explorer.
Blockscout
FEVM explorer.
Starboard
Network dashboards.
Public RPCs
Mainnet JSON-RPC endpoints.

Missing a source or tool? Open an issue.