Polymarket Get current positions for a user

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

Get current positions for a user from Polymarket. Returns the official Polymarket API response unchanged.

Price
$0.02USD / call
Method
POST
Response
JSON
Parameters
1 required · 11 optional
Production route

Try the model

Playground

Open playground
Input
Comma-separated list of event IDs. Mutually exclusive with market.
Include positions in archived markets that are still active. Archived positions are excluded by default.
0500
limit Range: 0 to 500.
Comma-separated list of condition IDs. Mutually exclusive with eventId.
mergeable
offset Range: 0 to 10000.
redeemable
sizeThreshold Minimum: 0.
sortBy Allowed values: CURRENT, INITIAL, TOKENS, CASHPNL, PERCENTPNL, TITLE, RESOLVING, PRICE, AVGPRICE.
sortDirection Allowed values: ASC, DESC.
title
User address (required)
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

user
string · required
eventId
array · optional
includeArchived
boolean · optional
limit
integer · optional
market
array · optional
mergeable
boolean · optional
offset
integer · optional
redeemable
boolean · optional
sizeThreshold
number · optional
sortBy
string (CURRENT, INITIAL, TOKENS, CASHPNL, PERCENTPNL, TITLE, RESOLVING, PRICE, AVGPRICE) · optional
sortDirection
string (ASC, DESC) · optional
title
string · optional

Access

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

API README

Polymarket Get current positions for a user API

Get current positions for a user from Polymarket. Returns the official Polymarket API response unchanged.

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/positions", "user": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"}'

Parameters

NameTypeRequiredDescription
eventIdarrayNoComma-separated list of event IDs. Mutually exclusive with market.
includeArchivedbooleanNoInclude positions in archived markets that are still active. Archived positions are excluded by default.
limitintegerNolimit
marketarrayNoComma-separated list of condition IDs. Mutually exclusive with eventId.
mergeablebooleanNomergeable
offsetintegerNooffset
redeemablebooleanNoredeemable
sizeThresholdnumberNosizeThreshold
sortBystringNosortBy
sortDirectionstringNosortDirection
titlestringNotitle
userstringYesUser address (required)

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/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/positions" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "user": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
  "limit": 100,
  "offset": 0,
  "sortBy": "TOKENS",
  "mergeable": false,
  "redeemable": false,
  "sizeThreshold": 1,
  "sortDirection": "DESC",
  "includeArchived": false
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Polymarket$0.02 per callJSONAug 10, 2026
Polymarket$0.02 per callJSONOct 30, 2026
Polymarket$0.02 per callJSONOct 30, 2026
Polymarket$0.02 per callJSONOct 30, 2026
Polymarket$0.02 per callJSONOct 30, 2026
Polymarket$0.02 per callJSONOct 30, 2026

Questions

FAQ

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

Send a POST request to https://api.sandbase.ai/v1/api/polymarket/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 current positions for a user 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 current positions for a user API accept?

Required: user (string). Optional: eventId (array), includeArchived (boolean), limit (integer), market (array), mergeable (boolean) and offset (integer) and 5 more. The Parameters table and the Playground on this page list every field.

What does the Polymarket Get current positions for a user 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 current positions for a user 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.