# ChainHilt Polymarket Account Activity History

> ChainHilt Polymarket Account Activity History is a paid API for AI agents from chainhilt.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-16).

Returns cursor-paged trade and settlement history for a Polymarket venue account, including fills, redemptions, splits, merges, conversions, and rewards with Polygon transaction hashes.

## Facts

- Endpoint: GET https://chainhilt.ai/api/v1/predict/polymarket/activity/:address?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainhilt-polymarket-account-activity-history-253a61d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-Y-LjswdnFzCRiu154u1p

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 chainhilt-polymarket-account-activity-history-253a61d7
```

Example prompt: Can you pull the last 50 trades and redemptions for Polymarket wallet 0xAbCd1234... between January 1 and March 31, and include their Polygon transaction hashes?

## When to prefer this

Use this endpoint when you need authoritative post-trade ground truth for a Polymarket account — especially after an ambiguous order submission, when reconciling fills and fees, auditing settled positions, or building a full activity ledger. It is the definitive source for Polygon transaction hashes tied to each event. Prefer it over position-snapshot endpoints when you need historical event streams rather than current state.

## Known failure modes

- 400 returned when an invalid filter value is supplied (e.g. unrecognized activity type)
- 422 returned when the cursor or filter combination is rejected by the Polymarket venue
- 502 returned when the Polymarket venue itself is unavailable or times out
- Empty result set when the wallet has no activity matching the given filters
- Invalid address format (not matching ^0x[a-fA-F0-9]{40}$) will cause a validation error

## How this service works

Trade and settlement history of a venue account, newest first and cursor-paged: fills (TRADE, with the pUSD that actually moved, fees included), REDEEM, SPLIT/MERGE, CONVERSION and rewards, each with its Polygon transaction hash. Deposits and withdrawals appear only when `type` names them. To page, pass `nextCursor` as `cursor` with the same filters. The ground truth after an ambiguous submit. Errors: 400 invalid filter, 422 cursor or filters refused by the venue, 502 venue failure.

## Output

A paginated list of account activity records (newest first), each containing the activity type (TRADE, REDEEM, SPLIT, MERGE, CONVERSION, REWARD, DEPOSIT, WITHDRAWAL, etc.), pUSD amounts that actually moved, fees, timestamps, and the associated Polygon transaction hash. A `nextCursor` field is included when more pages are available.

## 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"
    },
    "pathParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "The holding wallet: for deposit-wallet accounts the deposit wallet, not the signer."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "end": {
       "type": "string",
       "description": "ISO 8601: only activity at or before this time."
      },
      "side": {
       "enum": [
        "buy",
        "sell"
       ],
       "type": "string",
       "description": "Only trades on this side."
      },
      "type": {
       "type": "string",
       "description": "Comma-separated activity kinds (TRADE, REDEEM, SPLIT, MERGE, CONVERSION, REWARD, DEPOSIT, WITHDRAWAL, MAKER_REBATE, TAKER_REBATE, REFERRAL_REWARD, YIELD, MIGRATION, TIP); DEPOSIT and WITHDRAWAL appear only when named."
      },
      "limit": {
       "type": "integer",
       "default": 100,
       "maximum": 1000,
       "minimum": 1,
       "description": "Rows per page (1-1000, default 100)."
      },
      "start": {
       "type": "string",
       "description": "ISO 8601: only activity at or after this time."
      },
      "cursor": {
       "type": "string",
       "minLength": 1,
       "description": "The previous page's `nextCursor`; send it with the same filters."
      },
      "conditionId": {
       "type": "string",
       "description": "Comma-separated bytes32 condition ids (up to 20) to keep only those markets."
      }
     }
    }
   },
   "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/chainhilt-polymarket-account-activity-history-253a61d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainhilt.ai](https://www.zero.xyz/host/chainhilt.ai/llms.txt)
