--- title: "Get Arkham Polymarket activity" method: POST path: "/polymarket/activity" tags: ["Polymarket"] --- # Get Arkham Polymarket activity `POST /polymarket/activity` Get Arkham Polymarket activity. $1.00 per call. ## Request body - object - `actions` union — Optional. Filter to one or more actions: buy, sell, split, merge, convert. Cannot be combined with eventType or directi… - string - number - boolean - union[] - union - string - number - boolean - `conditionID` union — Optional. Filter to a single market condition ID (all of its outcome tokens). - string - number - boolean - union[] - union - string - number - boolean - `cursor` union — Optional. Pass an empty value on the first request to use cursor pagination, then pass the returned nextCursor without… - string - number - boolean - union[] - union - string - number - boolean - `direction` union — Optional. Narrow trades to one side: buy or sell. Only valid with eventType=trade (or no eventType). - string - number - boolean - union[] - union - string - number - boolean - `endTime` union — Optional. Unix timestamp in seconds for the end of the range (exclusive). - string - number - boolean - union[] - union - string - number - boolean - `entityIDs` union — Optional. Filter to activity attributed to specific Arkham entity IDs. Combined with userAddresses using OR. - 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 - `eventType` union — Optional. Filter by event class: trade, split, merge, or convert. Use direction to narrow trades to one side. - string - number - boolean - union[] - union - string - number - boolean - `fastPagination` union — Fast pagination defaults to true. For offset pagination, set false to count matches up to 10,000. Cursor pagination alw… - string - number - boolean - union[] - union - string - number - boolean - `limit` union — Max results (default 50, max 500). - string - number - boolean - union[] - union - string - number - boolean - `maxPrice` union — Optional. Maximum per-share price as a 0-1 fraction. - string - number - boolean - union[] - union - string - number - boolean - `maxSize` union — Optional. Maximum trade size in whole outcome-token shares. - string - number - boolean - union[] - union - string - number - boolean - `maxUsd` union — Optional. Maximum notional (size * price) in whole USD. - string - number - boolean - union[] - union - string - number - boolean - `minPrice` union — Optional. Minimum per-share price as a 0-1 fraction. - string - number - boolean - union[] - union - string - number - boolean - `minSize` union — Optional. Minimum trade size in whole outcome-token shares. - string - number - boolean - union[] - union - string - number - boolean - `minUsd` union — Optional. Minimum notional (size * price) 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 - `sortBy` union — Column to order by: time (default), size (outcome-token shares), price (cents-per-share), usd (notional). - string - number - boolean - union[] - union - string - number - boolean - `sortOrder` union — Sort direction: asc or desc (default). - string - number - boolean - union[] - union - string - number - boolean - `startTime` union — Optional. Unix timestamp in seconds for the start of the range (inclusive). - string - number - boolean - union[] - union - string - number - boolean - `tokenAddresses` union — Optional. Filter to specific outcome token addresses. The conditionID, eventID, and tokenAddresses filters are intersec… - string - number - boolean - union[] - union - string - number - boolean - `userAddresses` union — Optional. Filter to specific Polymarket trade 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)