---
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`

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. Default: pnl. When status=closed, value is not ava…
    - 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 1 request 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.

---

[API](https://skmtc.net/arkm/apis/arkham-x402.md) · [All operations](https://skmtc.net/arkm/apis/arkham-x402/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkm/arkham-x402/revisions/7830c19a58c4/schema)