---
title: "Get Arkham Polymarket wallet event history"
method: POST
path: "/polymarket/wallet/event-history"
tags: ["Polymarket"]
---

# Get Arkham Polymarket wallet event history

`POST /polymarket/wallet/event-history`

## Request

- Base URL: `https://api.arkm.com/x402`
- URL: `https://api.arkm.com/x402/polymarket/wallet/event-history`
- Auth: none required

Get Arkham Polymarket wallet event history. $0.60 per call.

## Request body

- object
  - `addr` union, required: Required. Polymarket trade address (0x + 40 hex chars).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `status` union, required: Required. Position state: open or closed.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `category` union: Optional. Filter events to a curated category.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `eventID` union: Optional. Filter to one Polymarket event.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `limit` union: Results per page (1-100, default 20).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `maxPnl` union: Maximum aggregate PnL in whole USD (can be negative).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `maxTotalBuyUsdc` union: Maximum aggregate buy amount in whole USD.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `maxTotalSellUsdc` union: Maximum aggregate sell amount in whole USD.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `maxTrades` union: Optional. Maximum aggregate trade count.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `maxValue` union: Maximum aggregate current value in whole USD. Open positions only.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `maxVolume` union: Maximum aggregate volume in whole USD.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `minPnl` union: Minimum aggregate PnL in whole USD (can be negative).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `minTotalBuyUsdc` union: Minimum aggregate buy amount in whole USD.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `minTotalSellUsdc` union: Minimum aggregate sell amount in whole USD.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `minTrades` union: Optional. Minimum aggregate trade count.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `minValue` union: Minimum aggregate current value in whole USD. Open positions only.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `minVolume` union: Minimum aggregate volume in whole USD.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `offset` union: Offset for pagination (default 0).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `order` union: Sort order: asc or desc. Default: desc.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `search` union: Optional. Search event titles.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `sort` union: Sort field: value, volume, trades, pnl, buyUsd, sellUsd, or endDate (resolution eligibility). Default: pnl. When status…
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean

## Response `200`

Successful response

- unknown

## Other responses

- `400`: Fatal for the request as written: validation failed or required JSON body fields are missing. Fix the request; do not retry it unchanged. Payment is not settled.
- `402`: Payment challenge, not an application error. Read the base64 x402 v2 challenge from PAYMENT-REQUIRED, sign it, and retry the same request with PAYMENT-SIGNATURE. If a post-payment 402 omits PAYMENT-REQUIRED, verification failed: read the new challenge, re-sign, and retry once.
- `404`: The upstream Arkham resource does not exist. Fatal for the same input. Payment is not settled.
- `429`: Per-wallet endpoint rate limit exceeded. Retry with at least 1 second of backoff; keep heavy endpoints at no more than 5 requests per second.
- `5XX`: Arkham failed or timed out, including 502 and 504 responses. Retry with backoff. x402 payments and MPP transaction credentials are not settled for failed requests; MPP hash credits are redeemed at admission and are not refunded automatically.

## Changes

- **2026-10-27** `60e4a5fdbecc`: 22 breaking
  - request property `additionalProperties/anyOf[subschema #4]/items/` list-of-types was narrowed by removing types `boolean and number` from media type `application/json`
  - request property `addr/anyOf[subschema #4]/items/` list-of-types was narrowed by removing types `boolean and number` from media type `application/json`
  - request property `category/anyOf[subschema #4]/items/` list-of-types was narrowed by removing types `boolean and number` from media type `application/json`
  - request property `eventID/anyOf[subschema #4]/items/` list-of-types was narrowed by removing types `boolean and number` from media type `application/json`
  - …18 more

[Operation history](https://skmtc.dev/arkm/apis/arkham-x402/changes/polymarket/wallet/event-history/post.md)

---

[API](https://skmtc.dev/arkm/apis/arkham-x402.md) - [All operations](https://skmtc.dev/arkm/apis/arkham-x402/llms.txt) - [OpenAPI document](https://skmtc.dev/arkm/apis/arkham-x402/revisions/60e4a5fdbecc?raw)