> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> What Blockgence is, what you can do with the API and where to start.

Blockgence is an on-chain intelligence platform for investigating funds on EVM networks. It traces the path of funds,
attributes addresses to known entities, runs explainable risk screening and analyzes contracts and incidents. Every
result says where it comes from and what could not be seen.

There are three ways to use it, and all three share your account, your cases and your credit quota:

> [card] [Web app](https://app.blockgence.com)
>
> The investigation canvas, cases, Monitor, Guard and Audit, with your user.

> [card] [REST API](https://docs.blockgence.com/en/api/authentication.md)
>
> The same queries from your code, under `/v1`, with an API key.

> [card] [MCP](https://docs.blockgence.com/en/mcp/connect.md)
>
> Connect your AI assistant (Claude, Cursor, Codex…) and query from the chat.

## What you can query

* **Fund tracing:** the transfer graph from an address or from the transaction of a theft, including bridge crossings
  and swaps.
* **Attribution and screening:** entity labels, OFAC sanctions with their history and an explained risk score.
* **Contracts and tokens:** who controls a contract, transaction simulation and a token profile.
* **Incidents:** the decoded exploit transaction, approvals and signature drains, the compromise vector, freeze status
  with stablecoin issuers and the evidence package.
* **Cases and evidence:** save an investigation, share it with your organization and export a sealed, verifiable
  package.

Ethereum, BNB Chain, Polygon, Arbitrum, Base, Optimism and, on the functions that say so, Tron are queried. The exact
list, with what can be queried on each one, is returned by `GET /v1/chains` (free). It also lists networks that are only
recognized and not read (`queryable: false`), such as Monero or Bitcoin.

## First steps

**1. Request an account**

Access is by invitation. Request one from the website and, once it is approved, you get a link to create your user.
See [Accounts and organizations](https://docs.blockgence.com/en/get-started/accounts-and-organizations.md).

**2. Create a key**

In the app, your name's menu → **MCP…** → *Crear clave* (create key). The same key works for the API and for the MCP.
See [API keys](https://docs.blockgence.com/en/get-started/api-keys.md).

**3. Make your first request**

```bash theme={null}
curl https://app.blockgence.com/v1/account \
  -H "Authorization: Bearer $BKG_KEY"
```

It returns your plan, your limits and what you have used this month. It costs no credits.

## How responses work

> [accordion] A failure is never «no data»
>
> If a data source fails, the response says so. If what you asked for could not be read, you get a `503` and are not
> charged; if an intermediate step failed, the response still arrives, with `degraded_sources`. See
> [Errors](https://docs.blockgence.com/en/api/errors.md).

> [accordion] Cutoffs are declared
>
> Reads have caps. Whatever was left unread travels in the response, with the missing range and how to ask for more.
> See [Pagination and cutoffs](https://docs.blockgence.com/en/api/pagination-and-cutoffs.md).

> [accordion] Facts and leads are kept apart
>
> An on-chain fact and a heuristic are not worth the same. Every claim states its basis and its confidence; leads are
> labeled as leads. The full methodology is published and can be queried through the API.

> [accordion] Only successful responses are charged
>
> An error costs no credits. See [Credits and limits](https://docs.blockgence.com/en/get-started/credits-and-limits.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.