--- title: "Get Arkham Polymarket wallet prediction history" method: POST path: "/polymarket/wallet/prediction-history" tags: ["Polymarket"] --- # Get Arkham Polymarket wallet prediction history `POST /polymarket/wallet/prediction-history` Get Arkham Polymarket wallet prediction 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 - `conditionID` union — Optional. Filter to a single market condition ID. - string - number - boolean - union[] - union - string - number - boolean - `eventID` union — Optional. Filter to all markets and outcomes in a 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 - `maxAvgBuyPrice` union — Maximum average buy price as a 0-1 fraction. - string - number - boolean - union[] - union - string - number - boolean - `maxAvgSellPrice` union — Maximum average sell price as a 0-1 fraction. - string - number - boolean - union[] - union - string - number - boolean - `maxCurrentPrice` union — Maximum current price as a 0-1 fraction. - string - number - boolean - union[] - union - string - number - boolean - `maxPnl` union — Maximum PnL in whole USD (can be negative). - string - number - boolean - union[] - union - string - number - boolean - `maxSharesHeld` union — Maximum remaining held shares in whole shares. - string - number - boolean - union[] - union - string - number - boolean - `maxTotalBuyUsdc` union — Maximum total buy amount in whole USD. - string - number - boolean - union[] - union - string - number - boolean - `maxTotalSellUsdc` union — Maximum total sell amount in whole USD. - string - number - boolean - union[] - union - string - number - boolean - `maxTrades` union — Optional. Maximum trade count. - string - number - boolean - union[] - union - string - number - boolean - `maxValue` union — Maximum current held value in whole USD. - string - number - boolean - union[] - union - string - number - boolean - `maxVolume` union — Maximum total volume in whole USD. - string - number - boolean - union[] - union - string - number - boolean - `minAvgBuyPrice` union — Minimum average buy price as a 0-1 fraction. - string - number - boolean - union[] - union - string - number - boolean - `minAvgSellPrice` union — Minimum average sell price as a 0-1 fraction. - string - number - boolean - union[] - union - string - number - boolean - `minCurrentPrice` union — Minimum current price as a 0-1 fraction. - string - number - boolean - union[] - union - string - number - boolean - `minPnl` union — Minimum PnL in whole USD (can be negative). - string - number - boolean - union[] - union - string - number - boolean - `minSharesHeld` union — Minimum remaining held shares in whole shares. - string - number - boolean - union[] - union - string - number - boolean - `minTotalBuyUsdc` union — Minimum total buy amount in whole USD. - string - number - boolean - union[] - union - string - number - boolean - `minTotalSellUsdc` union — Minimum total sell amount in whole USD. - string - number - boolean - union[] - union - string - number - boolean - `minTrades` union — Optional. Minimum trade count. - string - number - boolean - union[] - union - string - number - boolean - `minValue` union — Minimum current held value in whole USD. - string - number - boolean - union[] - union - string - number - boolean - `minVolume` union — Minimum total 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 market question, group title, event title, or condition ID. - string - number - boolean - union[] - union - string - number - boolean - `sort` union — Sort field: value, volume, currentPrice, trades, pnl, shares, buyUsd, avgBuy, sellUsd, avgSell. Default: pnl. When stat… - string - number - boolean - union[] - union - string - number - boolean - `status` union — Optional. Filter by position state: open or closed. - string - number - boolean - union[] - union - string - number - boolean - `tokenAddresses` union — Optional. Filter to specific outcome token addresses. - 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)