# Blockpin ERC-20 Token Flow Check

> Blockpin ERC-20 Token Flow Check is a paid API for AI agents from check.blockpin.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Returns all ERC-20 transfers of a specific token into and out of a given address since a start block, with totals, net flow, top counterparties, largest transfers, and current balance.

## Facts

- Endpoint: GET https://check.blockpin.dev/flows?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockpin-erc-20-token-flow-check-d8b74528
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UwJjNgfuOZW1NImTEsRzN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockpin-erc-20-token-flow-check-d8b74528
```

Example prompt: Can you check all USDC flows into the vault address 0xAbC...123 on Base since block 10000000 — I want to know the total in, total out, net, and who the biggest senders are?

## When to prefer this

Choose this endpoint when you need to audit or verify ERC-20 token flows through a specific address on Ethereum, Base, or Robinhood Chain — especially to fact-check protocol claims like 'X% of fees go to the vault', investigate treasury movements, or understand the net position and counterparty relationships of any wallet. Prefer this over a generic block explorer when you need aggregated totals, net flow, top counterparties, and largest transfers in a single structured response rather than raw transaction lists.

## Known failure modes

- Invalid token or address format (must be 0x-prefixed 40-hex-character addresses)
- Start block is too far back (Ethereum: max 1,000,000 blocks; Robinhood Chain: max 7,000,000 blocks)
- Unsupported chain value (must be 'ethereum', 'base', or 'robinhood')
- No transfers found for the given token/address/block range (empty result)
- Payment not confirmed (x402 payment required at $0.01 USDC per call)
- RPC timeout for high-volume addresses with many transfers

## How this service works

Token flow check: every ERC-20 Transfer of one token into and out of an address (a vault, treasury, fee receiver or wallet) since block N, with totals, net, top counterparties, the largest transfers and the balance now. Use it to check claims like 'x% of every trade lands in the vault'. Ethereum, Base and Robinhood Chain. Independent, by Blockpin; not a Claus Network service.

## Output

Returns a structured JSON object with a human-readable summary, incoming transfer totals (count and amount), outgoing transfer totals (count and amount), net flow, top counterparties by volume, the largest individual transfers, and the current token balance of the address at the latest block checked.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain",
      "token",
      "address",
      "since"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "robinhood"
       ],
       "type": "string"
      },
      "since": {
       "type": "string",
       "pattern": "^[0-9]+$",
       "description": "Start block (Ethereum: up to 1,000,000 back; Robinhood Chain: up to 7,000,000)"
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC-20 token address"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Address whose flows to sum (vault, treasury, fee receiver, wallet)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "summary",
      "incoming",
      "outgoing"
     ],
     "properties": {
      "net": {
       "type": "string"
      },
      "summary": {
       "type": "string"
      },
      "incoming": {
       "type": "object"
      },
      "outgoing": {
       "type": "object"
      },
      "balanceAtToBlock": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockpin-erc-20-token-flow-check-d8b74528/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from check.blockpin.dev](https://www.zero.xyz/host/check.blockpin.dev/llms.txt)