# ISHOB Token Flows

> ISHOB Token Flows is a paid API for AI agents from api.ishob.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-15).

Returns on-chain buy/sell/transfer activity for a token over 1h/6h/24h with volume, net flow, top traders, largest trades, and wash-trading signals across 6 EVM chains

## Facts

- Endpoint: GET https://api.ishob.com/v1/crypto/token-flows?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ishob-token-flows-3d1d8da0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8dBjzfZpRgm6Y4oHfYidW

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 ishob-token-flows-3d1d8da0
```

Example prompt: Show me who's buying and selling the USDC token (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum over the last 24 hours — I want buy vs sell volume, the top net buyers and sellers, the biggest individual trades, and whether there are any wash-trading signals.

## When to prefer this

Use this endpoint when you need granular, real-time on-chain flow analysis for a specific token — including wash-trading detection and wallet-level buyer/seller attribution — across Ethereum, Base, Arbitrum, Optimism, Polygon, or BNB Chain. Prefer this over generic DEX aggregators when you need per-wallet identification of top traders, transaction-hash-level trade evidence, or a machine-readable organic activity score for bot/manipulation detection.

## Known failure modes

- Invalid or non-checksummed contract address returns 400 error
- Token not indexed on the requested chain returns 404 or empty result
- Unsupported chain value returns validation error
- Very low-liquidity tokens with no transfers in the window return zero-volume results
- Rate limiting or payment failure returns 402

## How this service works

Who is buying and selling a token right now: every on-chain transfer in the last 1h / 6h / 24h split into DEX buys, sells and wallet transfers. Returns buy vs sell volume and net flow in USD, unique buyers and sellers, top net buyers and sellers, the largest trades (with tx hashes) and an organic-activity score with wash-trading signals (round-tripping, volume concentration, repeated bot-size trades). Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain.

## Output

Returns structured JSON with: buy volume and sell volume in USD, net flow (buys minus sells), count of unique buyers and sellers, ranked list of top net buyers and sellers by wallet address, list of the largest individual trades with transaction hashes and USD sizes, an organic-activity score (0–1), and wash-trading signal flags (round-tripping, volume concentration, repeated bot-size trades). Data is scoped to the requested time window (1h, 6h, or 24h).

## 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",
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "arbitrum",
        "optimism",
        "polygon",
        "bsc"
       ],
       "type": "string"
      },
      "window": {
       "enum": [
        "1h",
        "6h",
        "24h"
       ],
       "type": "string",
       "default": "1h",
       "description": "Look-back window"
      },
      "address": {
       "type": "string",
       "maxLength": 42,
       "description": "Token contract (0x...)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ishob-token-flows-3d1d8da0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ishob.com](https://www.zero.xyz/host/api.ishob.com/llms.txt)