# 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

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        |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chain-love.gitbook.io/chain-love-docs/blockchains/filecoin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
