# Base Token Flow Reconstruct

> Base Token Flow Reconstruct is a paid API for AI agents from signalharness.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Reconstructs and analyzes token transfer flows on the Base blockchain, building a per-account ledger of inflows, outflows, and net positions from caller-supplied transfer data.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/base_token_flow_reconstruct/invoke
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-token-flow-reconstruct-a1e39db2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1Fn26kTiSAUyNTr-xnaxi

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 base-token-flow-reconstruct-a1e39db2 -d '<json body>'
```

Example prompt: Reconstruct the token flow ledger for these Base mainnet ERC-20 transfers — I want to see each wallet's net position, total inflows, and total outflows: [paste transfer JSON here].

## When to prefer this

Choose this endpoint when you have a set of already-fetched on-chain token transfer records and need to aggregate them into a clean per-wallet ledger showing net flows — it does not fetch on-chain data itself, so it's best paired with a transfer-fetching step. Prefer this over generic blockchain explorers when you need structured, machine-readable net-flow analysis specifically for Base (OP Stack) with deterministic accounting guarantees.

## Known failure modes

- Malformed or invalid request_json causes parsing failure
- Transfer data referencing unsupported chain IDs outside Base (8453) and Base Sepolia (84532) may produce incomplete results
- Missing or incorrect decimal metadata could cause amount misinterpretation (service warns decimals are never invented)
- Empty transfer list returns a zero-entry ledger with warnings
- Payment failure via x402 returns HTTP 402 before execution begins

## How this service works

Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.

## Output

Returns a JSON analysis containing a per-account ledger (each entry with account address, asset contract, chain ID, in-amount, out-amount, and net amount), a network context block (accepted chain IDs, fee model, protocol family), and a total transfer count. Also includes evidence scope, analyzed network identifier, and warnings about data provenance limitations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "request_json": {
   "type": "string",
   "maxLength": 65536,
   "minLength": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "warnings": [
    "Results cover only supplied transfers and decimals are never invented."
   ],
   "service_id": "base_token_flow_reconstruct",
   "analysis_json": "{\"ledger\":[{\"account\":\"0x0000000000000000000000000000000000000001\",\"asset\":\"0x0000000000000000000000000000000000000001\",\"chain\":\"8453\",\"in\":\"0\",\"net\":\"-100\",\"out\":\"100\"},{\"account\":\"0x0000000000000000000000000000000000000002\",\"asset\":\"0x0000000000000000000000000000000000000001\",\"chain\":\"8453\",\"in\":\"100\",\"net\":\"100\",\"out\":\"0\"}],\"network_context\":{\"accepted_chain_ids\":[\"8453\",\"84532\"],\"deposit_transaction_type\":\"0x7e\",\"fee_model\":\"L2 execution plus caller-supplied L1 data/operator components\",\"protocol_family\":\"OP Stack\"},\"transfer_count\":1}",
   "evidence_scope": "caller_supplied_data",
   "analyzed_network": "base"
  },
  "status": "succeeded",
  "receipt": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "usage": [],
   "status": "succeeded",
   "network": "eip155:8453",
   "artifacts": [],
   "endedAtMs": 0,
   "latencyMs": 0,
   "paymentId": "example-payment",
   "receiptId": "example-receipt",
   "requestId": "example-request",
   "serviceId": "base_token_flow_reconstruct",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "20000",
   "resultSha256": "3407df0907e5ed4eaf12a1e6ffcd90cd296b2da68ac296d10cc888b629ff660e",
   "serviceVersion": "1.0.0",
   "settlementReference": "0x0000000000000000000000000000000000000000000000000000000000000000"
  },
  "artifacts": [],
  "requestId": "example-request",
  "executionId": "example-execution"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-token-flow-reconstruct-a1e39db2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signalharness.ai](https://www.zero.xyz/host/signalharness.ai/llms.txt)