# Oblique Markets Token Flow Activity

> Oblique Markets Token Flow Activity is a paid API for AI agents from api.oblique.markets, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches recent Solana token-flow activity for a wallet or token mint, returning normalized per-transaction token flows, counterparties, activity type, and program labels without requiring an indexer account.

## Facts

- Endpoint: POST https://api.oblique.markets/api/v1/paid/token-flow-activity
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oblique-markets-token-flow-activity-8c434c82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JEdSEKIw13U6qAl69ZrqQ

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 oblique-markets-token-flow-activity-8c434c82 -d '<json body>'
```

Example prompt: Pull the last 50 token flow transactions for Solana wallet Civ6KVQdBMnHHy4ViXGLRmMLh4Z4tJ6dprqWj4nEAyRh over the past 24 hours, showing any activity type and both inbound and outbound flows.

## When to prefer this

Use this endpoint when an agent needs on-demand Solana token-flow intelligence for a specific wallet or mint without setting up or paying for a dedicated indexer account. It is ideal for lightweight, per-call analytics where cost is predictable at $0.02/call and no persistent infrastructure is needed. Prefer it over full indexer solutions when the agent only occasionally needs token movement data and wants activity classification (transfer, swap, mint_burn) with counterparty and DEX program context already normalized.

## Known failure modes

- Missing both mint and address — endpoint requires at least one subject to query
- Invalid Solana address format causes rejection
- window_hours too large may result in partial results (partial:true in response)
- RPC upstream unavailability may cause delayed or failed responses
- Payment failure via x402 results in 402 response with no data
- before cursor from a different query context may cause unexpected pagination behavior

## How this service works

Use when an agent needs recent Solana token-flow activity for one wallet or token mint without an indexer account: which tokens moved, in which direction, with whom, and whether a public DEX program was involved. Returns normalized per-transaction flows (mint, owner, signed delta, decimals), counterparties, an activity read (transfer, swap, mint_burn), program labels, block time and slot, RPC provenance, freshness and a receipt with repeat-payer evidence. $0.02 per call via x402 on Solana or Bas

## Output

Returns a JSON object containing: a chain identifier, a pagination cursor, the time window queried, active filters, a list of activity entries each with per-flow details (mint, owner, signed delta, decimals, direction, token account, token program), counterparties, involved program labels, fee payer, transaction signature, block time, slot, activity type (transfer/swap/mint_burn), and RPC provenance metadata. Also includes a receipt with payer info, RPC call count, upstream host, repeat-payer flag, and cache status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mint": {
   "type": "string"
  },
  "limit": {
   "type": "integer"
  },
  "before": {
   "type": "string"
  },
  "address": {
   "type": "string"
  },
  "activity": {
   "enum": [
    "any",
    "transfer",
    "swap",
    "mint_burn"
   ],
   "type": "string"
  },
  "direction": {
   "enum": [
    "any",
    "in",
    "out"
   ],
   "type": "string"
  },
  "window_hours": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "solana:5eykt4UsFv8P8NJd…",
  "cursor": {
   "before": "2s4yjhs99Xd93KnbqDVb4Uq…"
  },
  "window": {
   "hours": 24,
   "since": "2026-09-06T12:00:00.000Z",
   "until": "2026-09-07T12:00:00.000Z"
  },
  "filters": {
   "mint": null,
   "activity": "any",
   "direction": "any"
  },
  "partial": false,
  "receipt": {
   "sku": "token-flow-activity",
   "payer": "AisyQi7zL7cR3q6sftsv7aV…",
   "rpc_calls": 4,
   "upstreams": [
    "solana-rpc.publicnode.c…"
   ],
   "prior_calls": 0,
   "request_hash": "3f2a9c1e0b7d4c6a8e5f1d2…",
   "is_repeat_payer": false,
   "payment_network": "solana:5eykt4UsFv8P8NJd…",
   "transactions_from_cache": 0
  },
  "scanned": 3,
  "subject": {
   "kind": "wallet",
   "address": "Civ6KVQdBMnHHy4ViXGLRmM…"
  },
  "activity": [
   {
    "slot": 445009885,
    "flows": [
     {
      "mint": "EPjFWdd5AufqSSqeM2qN1xz…",
      "delta": -5,
      "owner": "Civ6KVQdBMnHHy4ViXGLRmM…",
      "symbol": "USDC",
      "decimals": 6,
      "direction": "out",
      "is_subject": true,
      "delta_atomic": "-5000000",
      "token_account": "EMrJf5kf5jhBLvghNemar19…",
      "token_program": "spl-token"
     }
    ],
    "status": "success",
    "programs": [
     "associated-token-account"
    ],
    "fee_payer": "FHpcNSe6tb2n15bAdq4BkeY…",
    "signature": "2s4yjhs99Xd93KnbqDVb4Uq…",
    "block_time": "2026-09-06T14:15:42.000Z",
    "provenance": {
     "host": "solana-rpc.publicnode.c…",
     "cached": false,
     "method": "getTransaction",
     "source": "solana-public-rpc",
     "commitment": "finalized"
    },
    "fee_lamports": 5000,
    "activity_type": "transfer",
    "counterparties": [
     "7uTT8Xi5RWXzy7h9XL244GR…"
    ],
    "block_time_unix": 1788766542
   }
  ],
  "returned": 1,
  "freshness": {
   "cache": "miss",
   "cached_at": "2026-09-07T12:00:01.000Z",
   "served_at": "2026-09-07T12:00:01.000Z",
   "ttl_seconds": 120,
   "slot_at_fetch": 445010012
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oblique-markets-token-flow-activity-8c434c82/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.oblique.markets](https://www.zero.xyz/host/api.oblique.markets/llms.txt)
