x402basequality 0.92

Nansen Token God Mode: hourly token flow snapshots by holder category (smart money, whales, exchanges, public figures) via x402.

Price
per_call
Protocol
x402
Verified
no
Endpoint
https://api.nansen.ai/api/v1/tgm/flows

What it does

The Nansen TGM Flows endpoint (`POST /api/v1/tgm/flows`) returns aggregated token flow data over time for a specific token on a given blockchain. It provides hourly snapshots of balances, inflows, and outflows segmented by holder category: smart money, public figures, whales, exchanges, and top-100 holders. Each data point includes token amount, USD value, holder count, and separate inflow/outflow counts. When the label is set to "exchange", the response additionally breaks flows into DEX and CEX components.

This endpoint is part of the broader Nansen API v1, which covers smart money analytics, wallet profiling, token screening, perpetual trading data (Hyperliquid), prediction markets (Polymarket), and an AI research agent. The TGM Flows endpoint specifically costs $0.01 per call via the x402 payment protocol (or 10 credits on the free tier / 1 credit on the pro tier). It accepts a chain, token address, date range (ISO 8601), label type, pagination, optional filters (price, value, holder count, inflow/outflow ranges), and custom sort order. Supported chains include Ethereum, Solana, Base, BNB, Arbitrum, Polygon, and 18+ others.

The endpoint returned a 402 Payment Required response during probing, confirming it is live and accepting x402 payments. A full OpenAPI 3.1.0 schema is available with detailed request/response models, filter definitions, and sort field enums.

Capabilities

token-flow-analyticssmart-money-trackingwhale-trackingexchange-flow-monitoringholder-category-segmentationmulti-chain-supporthourly-snapshotsdex-cex-flow-breakdownx402-paymentpaginated-results

Use cases

  • —Track smart money accumulation or distribution of a specific token over time
  • —Monitor exchange inflows and outflows (CEX vs DEX) to detect potential sell pressure
  • —Analyze whale holder count and balance changes for a token across multiple chains
  • —Build time-series dashboards of token flows segmented by holder category
  • —Detect divergence between smart money flows and price action for trading signals

Fit

Best for

  • —Crypto traders monitoring smart money and whale activity on specific tokens
  • —DeFi analysts tracking exchange deposit/withdrawal patterns
  • —Quantitative researchers building on-chain flow models
  • —Portfolio managers assessing token accumulation trends

Not for

  • —Real-time sub-second trading signals (data is hourly snapshots)
  • —Non-crypto or traditional finance data needs
  • —Free unlimited usage (each call costs $0.01 via x402)

Quick start

curl -X POST https://api.nansen.ai/api/v1/tgm/flows \
  -H 'Content-Type: application/json' \
  -H 'Payment-Signature: <x402_payment_signature>' \
  -d '{
    "chain": "ethereum",
    "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
    "date": {"from": "2025-01-01T00:00:00Z", "to": "2025-01-07T23:59:59Z"},
    "label": "smart_money",
    "pagination": {"page": 1, "per_page": 10}
  }'

Example

Request

{
  "date": {
    "to": "2025-01-07T23:59:59Z",
    "from": "2025-01-01T00:00:00Z"
  },
  "chain": "ethereum",
  "label": "smart_money",
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}

Response

{
  "data": [
    {
      "date": "2025-01-01T00:00:00Z",
      "price_usd": 0.000012,
      "value_usd": 60000,
      "token_amount": 5000000000,
      "holders_count": 45,
      "total_inflows_cex": null,
      "total_inflows_dex": null,
      "total_outflows_cex": null,
      "total_outflows_dex": null,
      "total_inflows_count": 120000000,
      "total_outflows_count": 80000000
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": false
  }
}

Endpoint

URLhttps://api.nansen.ai/api/v1/tgm/flows
Transporthttp
Protocolx402
Pay to0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f
CurrencyUSD COIN

Quality

0.92/ 1.00

Full OpenAPI 3.1.0 schema with detailed request/response models, enums, and filter definitions. Live 402 x402 challenge confirmed. Clear pricing ($0.01/call). Only minor gap: no crawled documentation pages (all returned routing errors), so descriptions rely entirely on the OpenAPI spec.

Warnings

  • —No human-readable documentation pages were accessible (all returned 'no Route matched'); relying solely on OpenAPI spec for descriptions.
  • —Example response is synthesized from schema; no actual sample response was captured.

Citations

Provenance

Indexed fromx402_bazaar
Enriched2026-04-22 01:34:21Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-21
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/yUTzLx