> For the complete documentation index, see [llms.txt](https://chain-love.gitbook.io/chain-love-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chain-love.gitbook.io/chain-love-docs/blockchains/filecoin.md).

# Filecoin

<a href="https://filecoin.chain.love/" class="button primary" data-icon="arrow-up-right">Open Toolbox</a> <a href="https://filecoin.chain.love/configurations" class="button primary" data-icon="arrow-up-right">Open Performance</a> <a href="https://filecoin.chain.love/rpc" class="button primary" data-icon="arrow-up-right">Open API Management (RPC & Subgraphs)</a>

{% hint style="info" %} <img src="https://img.shields.io/badge/Toolbox-Enabled-green" alt="" data-size="original"><img src="https://img.shields.io/badge/Performance_module-Enabled-green" alt="" data-size="original"><img src="https://img.shields.io/badge/RPC-FREE_ANONYMOUS-brightgreen" alt="" data-size="original"><img src="https://img.shields.io/badge/Subgraphs-FREE-brightgreen" alt="" data-size="original">
{% endhint %}

Chain.Love on Filecoin is a **set of modules** that help you **discover** providers, **monitor** them, and (optionally) **access** RPC/Subgraphs through an API gateway.

## Recommended workflows

* **Discover providers (start here)**: open the [Toolbox](https://filecoin.chain.love/) → browse categories (RPC, Indexing, Wallets, etc.) → shortlist and compare offers.
* **Harden production access**: open [Performance](https://filecoin.chain.love/configurations) → set monitoring/notifications → configure routing and failover.
* **Need an RPC/Subgraphs right now**: open [API Management](https://filecoin.chain.love/rpc) → use RPC/Subgraphs endpoints (details below).

## Modules on Filecoin

### Toolbox (Discovery & comparison)

* **What it is**: a chain-specific marketplace/registry of Web3 services.
* **Key features**:
  * [Discover](https://chain-love.gitbook.io/chain.loves-toolbox/features/discover): browse categories and filter offers
  * [Compare](https://chain-love.gitbook.io/chain.loves-toolbox/features/compare): side-by-side comparison
  * [AI search](https://chain-love.gitbook.io/chain.loves-toolbox/features/ai-search): search across the database (including cross-ecosystem queries)
  * [Widget for docs](https://chain-love.gitbook.io/chain.loves-toolbox/features/widget-for-docs): embed a compact Toolbox view into documentation
  * [Contributing](https://chain-love.gitbook.io/chain.loves-toolbox/contributing/open-source-database): improve the open-source database
* **Open**: `https://filecoin.chain.love/`

### Performance (Monitoring & routing)

* **What it is**: a module to manage providers' performance.
* **Key areas**:
  * [Monitoring](https://github.com/Chain-Love/chain.love-docs/blob/main/modules/performance/monitoring/getting-started.md)
  * [Notifications](https://github.com/Chain-Love/chain.love-docs/blob/main/modules/performance/monitoring/notifications.md)
  * [Load balancer](https://github.com/Chain-Love/chain.love-docs/blob/main/modules/performance/load-balancer/getting-started.md)
  * [Performance agreements](https://github.com/Chain-Love/chain.love-docs/blob/main/modules/performance/performance-agreements/getting-started.md)
* **Open**: `https://filecoin.chain.love/configurations`

### API Management (RPC & Subgraphs)

This module is for **accessing** APIs (RPC/Subgraphs). If you’re evaluating providers or comparing options, start with the **Toolbox** section above.

#### RPC API highlights

This section highlights features and important details about the Filecoin RPC API.

**API versions**

Lotus offers 3 API versions: `/rpc/v0` includes only native methods (`Filecoin.*`), `/rpc/v1` supports EVM-compatible methods (`eth_*`), and `/rpc/v2` supports [F3](https://filecoin.io/blog/posts/how-f3-is-transforming-the-filecoin-network/)-aware methods. If you don't specify a version (making a request to [https://filecoin.chain.love](https://filecoin.chain.love/)), the default version used is `/rpc/v1`.

{% hint style="info" %}
**Notice**: Parameter differences exist for native methods between these versions.
{% endhint %}

**Batch requests**

Chain.Love RPC supports HTTP batch requests to the Filecoin RPC API, and the service currently allows up to 100 requests in a single batch.

Example:

```bash
curl --location 'https://filecoin.chain.love/rpc/v1' \
--header 'Content-Type: application/json' \
--data '[
    {
	    "jsonrpc":"2.0",
	    "method":"Filecoin.ChainHead",
	    "params":[],
	    "id":1
    },
    {
	    "jsonrpc":"2.0",
	    "method":"Filecoin.ChainHead",
	    "params":[],
	    "id":2
    }
]'
```

**Lotus Lite**

Chain.Love RPC offers endpoints compatible with Lotus Lite nodes. For more details, visit [Lotus Lite](https://lotus.filecoin.io/lotus/install/lotus-lite/). Start your Lotus Lite node by substituting the query key and endpoint in the command below:

```bash
FULLNODE_API_INFO=QUERY_KEY:ENDPOINT lotus daemon --lite
```

The available endpoints are:

| Network  | Endpoint                                  |
| -------- | ----------------------------------------- |
| Mainnet  | wss\://filecoin.chain.love/ws             |
| Calibnet | wss\://calibration.filecoin.chain.love/ws |

#### Subgraphs (Indexing)

You can query your subgraphs using the following methods:

* By **name**: `https://proxy.filecoin.chain.love/subgraphs/name/<SUBGRAPH_NAME>`

{% tabs %}
{% tab title="Mainnet" %}

```bash
# Assuming the subgraph name is `mainnet/blocks`
curl -X POST \
 -H "Content-Type: application/json" \
 -d '{"query":"query MyQuery {\r\n  blocks(first: 10) {\r\n    id\r\n  }\r\n}","variables":{}}' \
 "https://proxy.filecoin.chain.love/subgraphs/name/mainnet/blocks"
```

{% endtab %}
{% endtabs %}

#### Pricing (deprecated, see below for the new pricing)

This section serves as the definitive guide for all Filecoin-related pricing information

### Growth Plan

The Growth plan offers a cost-effective way to access Filecoin APIs. You pay a **one-time access fee** and then only **pay for the** [**credits**](https://chain-love.gitbook.io/chain.loves-api-management-module/help-and-faq/glossary) you use. The underlying **infrastructure is shared** between you and other users.

| Endpoint              | Network  | Data Availability            | Access Fee | Cost per 1M [Credits](https://chain-love.gitbook.io/chain.loves-api-management-module/help-and-faq/glossary) |
| --------------------- | -------- | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------ |
| Recent-state mainnet  | Mainnet  | Latest 2k blocks             | Free       | $1                                                                                                           |
| FVM archive mainnet   | Mainnet  | All blocks since FEVM launch | $300       | $1.5                                                                                                         |
| Full archive mainnet  | Mainnet  | All blocks since genesis     | $500       | $3                                                                                                           |
| Recent-state calibnet | Calibnet | Latest 2k blocks             | Free       | $0.5                                                                                                         |
| Full archive calibnet | Calibnet | All blocks since genesis     | $100       | $1.5                                                                                                         |

{% hint style="info" %}
**Notice**: Recent-state mainnet and recent-state calibnet endpoints have separate HTTPS and WebSocket implementations that are **shown as separate endpoints in the UI**. This is purely a UI implementation detail so do not be confused: they are **billed as a single endpoint**.
{% endhint %}

### Dedicated Nodes

The Dedicated plan provides **exclusive nodes** for your specific needs. You only pay a **fixed monthly fee**. The underlying **infrastructure is dedicated to you**.

| Network  | Data Availability            | Monthly Fee |
| -------- | ---------------------------- | ----------- |
| Mainnet  | Latest 2K blocks             | $1000       |
| Mainnet  | All blocks since FEVM launch | $3500       |
| Mainnet  | All blocks since genesis     | $5000       |
| Calibnet | Latest 2K blocks             | $600        |
| Calibnet | All blocks since genesis     | $800        |

## Pricing changes (effective August 3rd 2026)

### Anonymous plan

Anonymous plan is available on recent-state RPC endpoints and is rate-limited every minute. The underlying **infrastructure is shared** between you and other users.

| Endpoint             | Network           | Data Availability | Access Fee | Rate limiting                          |
| -------------------- | ----------------- | ----------------- | ---------- | -------------------------------------- |
| Recent-state mainnet | Mainnet, calibnet | Latest 2k blocks  | $0         | 100 requests per minute per IP address |

### Free Plan

Free plan is available on Subgraphs and recent-state RPC, and is partially limited on the number of requests you may make per month. The underlying **infrastructure is shared** between you and other users.

| Endpoint             | Network           | Data Availability            | Access Fee | Rate limiting                                                                                                                       |
| -------------------- | ----------------- | ---------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Recent-state mainnet | Mainnet, calibnet | Latest 2k blocks             | $0         | 10M [Credits](https://chain-love.gitbook.io/chain.loves-api-management-module/getting-started-with-rpc/create-query-keys) per month |
| Subgraphs            | Mainnet, calibnet | All blocks since FEVM launch | $0         | None                                                                                                                                |

### Growth Plan

The Growth plan offers a cost-effective way to access Filecoin APIs. You pay a **one-time access fee** and then only **pay for the** [**credits**](https://chain-love.gitbook.io/chain.loves-api-management-module/help-and-faq/glossary) you use. The underlying **infrastructure is shared** between you and other users. 10M free CU per month applied every month additionally.

| Endpoint              | Network  | Data Availability            | Access Fee | Cost per 1M Credits |
| --------------------- | -------- | ---------------------------- | ---------- | ------------------- |
| Recent-state mainnet  | Mainnet  | Latest 2k blocks             | Free       | $1                  |
| FVM archive mainnet   | Mainnet  | All blocks since FEVM launch | $29        | $15                 |
| Full archive mainnet  | Mainnet  | All blocks since genesis     | $39        | $25                 |
| Recent-state calibnet | Calibnet | Latest 2k blocks             | Free       | $0.5                |
| Full archive calibnet | Calibnet | All blocks since genesis     | $19        | $1.5                |

{% hint style="info" %}
**Notice**: Recent-state mainnet and recent-state calibnet endpoints have separate HTTPS and WebSocket implementations that are **shown as separate endpoints in the UI**. This is purely a UI implementation detail so do not be confused: they are **billed as a single endpoint**.
{% endhint %}

### Dedicated Nodes

The Dedicated plan provides **exclusive nodes** for your specific needs. You only pay a **fixed monthly fee**. The underlying **infrastructure is dedicated to you**.

| Network  | Data Availability            | Monthly Fee |
| -------- | ---------------------------- | ----------- |
| Mainnet  | Latest 2K blocks             | $300        |
| Mainnet  | All blocks since FEVM launch | $800        |
| Mainnet  | All blocks since genesis     | $1200       |
| Calibnet | Latest 2K blocks             | $150        |
| Calibnet | All blocks since genesis     | $300        |
