# Arkham x402 – Polymarket Wallet Tags

> Arkham x402 – Polymarket Wallet Tags is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-14).

Returns Polymarket prediction-market category tags and trading volume statistics associated with a given wallet address.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/wallet/tags
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-polymarket-wallet-tags-3ddb75b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PIoPzQtdJTMYw16Msyybr

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 arkham-x402-polymarket-wallet-tags-3ddb75b6 -d '<json body>'
```

Example prompt: Can you pull up the Polymarket category tags and trading volumes for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see which prediction market topics they trade most?

## When to prefer this

Use this endpoint when you need to categorize or profile a specific wallet's Polymarket trading behavior by topic — particularly to understand which prediction market verticals (sports, politics, crypto, etc.) the wallet is active in and at what volume. Prefer this over generic blockchain explorers when you want Arkham's curated intelligence layer applied to Polymarket-specific activity.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty tag list
- Wallet has no Polymarket activity — returns empty tags array
- Payment failure via x402 protocol blocks the request
- Rate limiting if payment is not correctly attached
- Wallet address not found on Polymarket returns no results

## How this service works

Get Arkham Polymarket wallet tags. $0.40 per call.

## Output

A JSON object containing the wallet address queried and an array of tag objects, each with a machine-readable tag key (e.g. 'sports'), a human-readable label, the number of prediction market events participated in, and cumulative trading volume in USD.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addr": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Required. Polymarket trade address (0x + 40 hex chars)."
  },
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Max tags to return, ranked by gross volume. Default 10, max 50."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tags": [
   {
    "tag": "sports",
    "label": "Sports",
    "events": 395308,
    "volume": "89223593.175383"
   },
   {
    "tag": "games",
    "label": "Games",
    "events": 186969,
    "volume": "84209306.842161"
   },
   {
    "tag": "nba",
    "label": "Nba",
    "events": 121481,
    "volume": "53470343.90196"
   }
  ],
  "userAddress": "0xBDDF61Af533fF524D27154e589d2D7A81510C684"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-polymarket-wallet-tags-3ddb75b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)