# kair-os.trade Smart Money Flow

> kair-os.trade Smart Money Flow is a paid API for AI agents from kair-os.trade, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Returns recent USDC token transfer flows for a Base token across sampled Uniswap V3 pool swaps, showing exact counterparties and nominal USDC amounts within a configurable time window.

## Facts

- Endpoint: POST https://kair-os.trade/smart-money/flow?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kair-os-trade-smart-money-flow-fb8e0c60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nKiGW0XEAVLf3Z3Q8ulXH

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 kair-os-trade-smart-money-flow-fb8e0c60 -d '<json body>'
```

Example prompt: Show me the smart money USDC flow for the Base token at 0x4200000000000000000000000000000000000006 over the last 24 hours — I want to see recent swap counterparties and how much USDC is moving.

## When to prefer this

Use this endpoint when you need raw, evidence-based on-chain swap data for a specific Base token — particularly the exact wallet counterparties and USDC amounts from recent Uniswap V3 pool transactions. It is best suited for short-window, real-time flow observation rather than historical PnL ranking or multi-pool aggregation. Choose this over higher-level analytics services when you need the underlying transfer-level data and are willing to do your own wallet qualification or scoring downstream.

## Known failure modes

- Invalid token address format returns a schema validation error
- Token has no active USDC Uniswap V3 pool on Base — returns empty or error
- Time window enum value not in {1h, 24h, 7d} causes request rejection
- No transactions found within the sampled block range — empty result set
- Payment authentication failure (x402) if USDC payment is not attached correctly

## How this service works

Base token flow evidence: recent sampled swaps in one authenticated direct USDC Uniswap V3 pool, exact transfer counterparties and nominal USDC flows. At most 1800 blocks and eight transactions. Historical PnL, winning-wallet qualification and qualified smart-money net flow are unknown; this version does not rank winning wallets.

## Output

Returns a list of up to 8 recent sampled swap transactions from a single authenticated Uniswap V3 USDC pool on Base, covering at most 1800 blocks. Each entry includes exact transfer counterparty addresses and nominal USDC flow amounts. Does not include historical PnL, wallet rankings, or smart-money qualification scores.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$"
  },
  "fenetre": {
   "enum": [
    "1h",
    "24h",
    "7d"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kair-os-trade-smart-money-flow-fb8e0c60/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kair-os.trade](https://www.zero.xyz/host/kair-os.trade/llms.txt)