# Oblique Markets Wallet Spy

> Oblique Markets Wallet Spy is a paid API for AI agents from api.oblique.markets, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Real-time surveillance of a blockchain wallet — transactions, token holdings, DEX swaps, NFTs, and risk score

## Facts

- Endpoint: GET https://api.oblique.markets/api/v1/paid/wallet-spy
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oblique-markets-wallet-spy-9a940cfd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6JaAa2Y__295PoZ3NubaW

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-wallet-spy-9a940cfd
```

Example prompt: Can you pull up a full wallet spy report on 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see their recent transactions, token holdings, DEX swaps, NFTs, and what their risk score looks like?

## When to prefer this

Choose this endpoint when you need a holistic, real-time picture of a single wallet's on-chain footprint including risk scoring — as opposed to just token flows (sibling endpoint) or pure SQL analytics. Ideal for due diligence, counterparty vetting, whale tracking, and fraud detection workflows where you need transactions, tokens, DEX, NFTs, and risk all in one call.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain or network returns no data
- Wallet with no on-chain activity may return empty datasets
- Payment failure (x402) blocks access if USDC balance is insufficient
- Rate limiting if too many requests are made in quick succession

## How this service works

Use when an agent wants to know what a wallet has been doing before paying it, accepting payment from it or following it. Returns Recent transactions, token transfers, DEX swaps, NFT activity and internal transactions for an EVM wallet on Base or Ethereum, with a heuristic risk score. $0.03.

## Output

Returns a comprehensive real-time profile of the queried wallet including: full transaction history, current token holdings, DEX swap activity, NFT assets, and a computed risk score that flags suspicious or high-risk behavior patterns.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base"
       ],
       "type": "string"
      },
      "address": {
       "type": "string",
       "description": "EVM wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "chain": {
     "type": "string"
    },
    "message": {
     "type": "string"
    },
    "queried_at": {
     "type": "string"
    },
    "risk_score": {
     "type": "object",
     "properties": {
      "level": {
       "type": "string"
      },
      "score": {
       "type": "integer"
      },
      "reasons": {
       "type": "array",
       "items": {
        "type": "string"
       }
      }
     }
    },
    "surveillance": {
     "type": "object",
     "properties": {
      "dexs_swaps": {
       "type": "object",
       "properties": {
        "count": {
         "type": "integer"
        },
        "items": {
         "type": "array"
        }
       }
      },
      "nft_activity": {
       "type": "object",
       "properties": {
        "count": {
         "type": "integer"
        },
        "items": {
         "type": "array"
        }
       }
      },
      "token_transfers": {
       "type": "object",
       "properties": {
        "count": {
         "type": "integer"
        },
        "items": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "to": {
            "type": "string"
           },
           "from": {
            "type": "string"
           },
           "hash": {
            "type": "string"
           },
           "token": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "symbol": {
              "type": "string"
             },
             "address": {
              "type": "nu
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "message": "Wallet surveillance via x402 protocol",
  "queried_at": "2026-09-12T00:09:51.442Z",
  "risk_score": {
   "level": "medium",
   "score": 25,
   "reasons": [
    "no_transaction_history"
   ]
  },
  "surveillance": {
   "dexs_swaps": {
    "count": 0,
    "items": []
   },
   "nft_activity": {
    "count": 0,
    "items": []
   },
   "token_transfers": {
    "count": 50,
    "items": [
     {
      "to": "0x970007590aCC5C938cd51345B17AF51B1B40D3Ab",
      "from": "0x7Cd443d93a981Ae154a78F4A9b4Fadb6E8A7A264",
      "hash": "0x244024778b5aff09fba5961a9e4d711260d929100b8225c46633275cf40ac3f1",
      "token": {
       "name": "USDC",
       "type": "ERC-20",
       "symbol": "USDC",
       "address": null,
       "decimals": "6"
      },
      "total": "0",
      "value": "4000",
      "method": "0xe3ee160e",
      "timestamp": "2026-09-12T00:09:03.000000Z"
     }
    ],
    "unique_tokens": 0
   },
   "recent_transactions": {
    "count": 0,
    "items": []
   },
   "internal_transactions": {
    "count": 0,
    "items": []
   }
  },
  "wallet_address": "0x970007590aCC5C938cd51345B17AF51B1B40D3Ab"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oblique-markets-wallet-spy-9a940cfd/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)
