--- 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` ## Request - Base URL: `https://api.arkm.com/x402` - URL: `https://api.arkm.com/x402/polymarket/wallet/prediction-history` - Auth: none required 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. Pass several as a single comma-separated value (e.g. '0xe29acc13…… - 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`: 31 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 `conditionID/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` - …27 more [Operation history](https://skmtc.dev/arkm/apis/arkham-x402/changes/polymarket/wallet/prediction-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)