Polymarket Get positions for a market

Name: Polymarket Get positions for a market
Price: 0.018 USD
Availability: InStock
Author: Polymarket

https://api.sandbase.ai/v1/api/polymarket/market-positions

Returns positions for a market, optionally filtered to a single user.

Try this API Get API key

Price: $0.02USD / call
Method: POST
Response: JSON
Parameters: 1 required · 6 optional

Production route

Try the model

Playground

Open playground

Input

Limit(integer)

0500

Max number of positions to return per outcome token Range: 0 to 500.

Market(string)

The condition ID of the market to query positions for

Offset(integer)

Pagination offset per outcome token Range: 0 to 10000.

SortBy(string)

Sort positions by: - `TOKENS` — Position size (number of tokens) - `CASH_PNL` — Unrealized cash PnL - `REALIZED_PNL` — Realized PnL - `TOTAL_PNL` — Total PnL (cash_pnl + realized_pnl) Allowed values: TOKENS, CASH_PNL, REALIZED_PNL, TOTAL_PNL.

SortDirection(string)

sortDirection Allowed values: ASC, DESC.

Status(string)

Filter positions by status. - `OPEN` — Only positions with size > 0.01 - `CLOSED` — Only positions with size <= 0.01 - `ALL` — All positions regardless of size Allowed values: OPEN, CLOSED, ALL.

User(string)

Filter to a single user by proxy wallet address

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.02 / run

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

market: string · required
limit: integer · optional
offset: integer · optional
sortBy: string (TOKENS, CASH_PNL, REALIZED_PNL, TOTAL_PNL) · optional
sortDirection: string (ASC, DESC) · optional
status: string (OPEN, CLOSED, ALL) · optional
user: string · optional

Access

Provider: Polymarket
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/polymarket/market-positions
Authentication: Bearer API key

API README

Polymarket Get positions for a market API

Returns positions for a market, optionally filtered to a single user.

The response is the official Polymarket API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "polymarket/market-positions", "market": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"}'

Parameters

Name	Type	Required	Description
`limit`	integer	No	Max number of positions to return per outcome token
`market`	string	Yes	The condition ID of the market to query positions for
`offset`	integer	No	Pagination offset per outcome token
`sortBy`	string	No	Sort positions by: - `TOKENS` — Position size (number of tokens) - `CASH_PNL` — Unrealized cash PnL - `REALIZED_PNL` — Realized PnL - `TOTAL_PNL` — Total PnL (c
`sortDirection`	string	No	sortDirection
`status`	string	No	Filter positions by status. - `OPEN` — Only positions with size > 0.01 - `CLOSED` — Only positions with size <= 0.01 - `ALL` — All positions regardless of size
`user`	string	No	Filter to a single user by proxy wallet address

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/polymarket/market-positions

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/polymarket/market-positions" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "user": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
  "limit": 50,
  "market": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
  "offset": 0,
  "sortBy": "TOTAL_PNL",
  "status": "ALL",
  "sortDirection": "DESC"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Polymarket Get positions for a marketThis API `Polymarket`	$0.02 per call	JSON	Oct 30, 2026
Polymarket Get user activity `Polymarket`	$0.02 per call	JSON	Oct 30, 2026
Polymarket Get order book `Polymarket`	$0.02 per call	JSON	Oct 30, 2026
Polymarket Get aggregated builder leaderboard `Polymarket`	$0.02 per call	JSON	Oct 30, 2026
Polymarket Get CLOB market info `Polymarket`	$0.02 per call	JSON	Oct 30, 2026
Polymarket Get closed positions for a user `Polymarket`	$0.02 per call	JSON	Oct 30, 2026

Questions

FAQ

How do I use the Polymarket Get positions for a market API?

Send a POST request to https://api.sandbase.ai/v1/api/polymarket/market-positions with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Polymarket Get positions for a market API cost?

$0.02 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Polymarket Get positions for a market API accept?

Required: market (string). Optional: limit (integer), offset (integer), sortBy (one of TOKENS, CASH_PNL, REALIZED_PNL, TOTAL_PNL), sortDirection (one of ASC, DESC), status (one of OPEN, CLOSED, ALL) and user (string). The Parameters table and the Playground on this page list every field.

What does the Polymarket Get positions for a market API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Polymarket developer account or API key?

No. Polymarket Get positions for a market runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Polymarket API access separately.