---
title: "PAID $0.01 — classified activity summary for any Flare wallet"
method: GET
path: "/api/paid/wallet-intelligence"
tags: ["payments", "paid"]
---

# PAID $0.01 — classified activity summary for any Flare wallet

`GET /api/paid/wallet-intelligence`

## Request

- Base URL: `https://www.flarewatch.io`
- URL: `https://www.flarewatch.io/api/paid/wallet-intelligence`
- Auth: none declared

The FlareWatch classification engine as a keyless machine API: activity breakdown by category/type, income event totals, DeFi protocols touched, live FTSO delegations. Pay per-request via PAYMENT-SIGNATURE / X-PAYMENT (x402 exact) or spend deposited credits via X-Api-Key. Unpaid requests receive 402 with spec-shaped terms regardless of query params, so discovery never requires guessing valid arguments.

## Query parameters

- `address` string, required

## Response `200`

Classified wallet summary. Successful responses carry a PAYMENT-RESPONSE header reporting what became of the authorization.

- WalletIntelligence: Classified activity summary for one Flare wallet — the output of the same classification engine the dashboard uses.
  - `address` string: The wallet queried, lowercased.
  - `paid_via` 'exact' | 'credits': Which rail paid for this call: x402 per-request, or deposited compute units.
  - `classified_events` integer: Total transfer/transaction events the engine classified for this wallet.
  - `by_category` object: Event counts keyed by category (e.g. reward, defi, transfer).
  - `by_type` object: Event counts keyed by the finer-grained type within a category.
  - `income` object: Income-classified subset. flr_denominated_total counts FLR and WFLR only — it is an amount, never a fiat valuation, because this endpoint reports classifications and does not price claims.
    - `events` integer
    - `flr_denominated_total` number
  - `defi_protocols` string[]: Distinct DeFi protocols this wallet interacted with, sorted.
  - `ftso_delegations` object[]: Live FTSO delegations read from chain at request time.
    - `provider` string
    - `name` string
    - `percent` number
  - `methodology` string: Where the classification rules are documented.

## Other responses

- `400`: Bad address — only reachable once payment has been presented; unpaid callers get 402 instead.
- `402`: Payment required. Returned for ANY unpaid request, including one with missing or malformed query params, so terms are discoverable without first guessing valid arguments.
- `429`: Rate limited — structured error + RateLimit headers.

---

[API](https://skmtc.dev/flarewatch/apis/flarewatch-public-api.md) · [All operations](https://skmtc.dev/flarewatch/apis/flarewatch-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flarewatch/apis/flarewatch-public-api/revisions/890e7013afdb?raw)