Polymarket

List a Polymarket trader’s positions

List a trader’s positions with size, average and current price, value, cost and realized and unrealized PnL. Choose open, closed, redeemable, redeemable_lost or mergeable positions, sort them, and page with the returned cursor. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/polymarket/user-positions

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/polymarket/user-positions
  • Auth: API key in header x-api-key

Query parameters

userstring required

Required. Trading wallet or owner wallet (0x plus 40 hex characters), @handle, or a polymarket.com/@handle or /profile/<wallet> URL. A handle is resolved to its trading wallet from the public profile page. An owner wallet is replaced by its trading wallet.

status'open' | 'closed' | 'redeemable' | 'redeemable_lost' | 'mergeable'

open (default; includes settled winners not yet redeemed), closed (exited), redeemable, redeemable_lost (losing positions still held) or mergeable (complementary pairs).

sortBy'current_value' | 'price' | 'tokens' | 'unrealized_pnl' | 'realized_pnl' | 'total_pnl' | 'timestamp'

current_value, price, tokens, unrealized_pnl, realized_pnl, total_pnl or timestamp. Defaults to current_value for open positions and realized_pnl for closed ones.

direction'asc' | 'desc'

desc (default) or asc.

limitstring

Positions per page, 1–500; defaults to 100.

cursorstring

Optional nextCursor from the previous response. Send the same other parameters with it; omit it for the first page.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.