Skip to main content
GET
https://api.aisa.one/apis/v1
/
polymarket
/
positions
/
wallet
/
{wallet_address}
Get Positions
curl --request GET \
  --url https://api.aisa.one/apis/v1/polymarket/positions/wallet/{wallet_address} \
  --header 'Authorization: Bearer <token>'
{ "wallet_address": "0x1234567890abcdef1234567890abcdef12345678", "positions": [ { "wallet": "0x1234567890abcdef1234567890abcdef12345678", "token_id": "19701256321759583954581192053894521654935987478209343000964756587964612528044", "condition_id": "0xabcd1234...", "title": "Will Bitcoin reach $100k by end of 2025?", "shares": 50000000, "shares_normalized": 50, "redeemable": false, "market_slug": "will-bitcoin-reach-100k-by-end-of-2025", "event_slug": "bitcoin-price-predictions", "image": "https://polymarket.com/images/...", "label": "Yes", "winning_outcome": null, "start_time": 1640995200, "end_time": 1672531200, "completed_time": null, "close_time": null, "game_start_time": null, "market_status": "open", "negativeRisk": false } ], "pagination": { "has_more": false, "limit": 100, "pagination_key": null } }
Positions fetches all active Polymarket positions held by a specific proxy wallet address. Returns positions with a balance of at least 10,000 shares (0.01 normalized), along with detailed market information including title, status, outcome labels, and redemption eligibility. Best for: Portfolio tracking, monitoring wallet holdings, identifying redeemable positions, analyzing wallet exposure across markets. Endpoint: GET /polymarket/positions/wallet/{wallet_address}

​
Example

curl -X GET "https://api.aisa.one/apis/v1/polymarket/positions/wallet/0x1234567890abcdef1234567890abcdef12345678?limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response

The response returns a wallet_address field, a positions array containing position objects with fields such as token ID, condition ID, title, shares (raw and normalized), redeemable status, market/event slugs, outcome label, winning outcome, and market status. A pagination object with has_more and pagination_key fields supports cursor-based pagination.

Authorizations

​
Authorization
string
header
required

Your AIsa API key as a Bearer token.

Path Parameters

​
wallet_address
string
required

The Proxy wallet address to fetch positions for

Pattern: ^0x[0-9a-fA-F]{40}$
Example:

"0x1234567890abcdef1234567890abcdef12345678"

Query Parameters

​
limit
integer
default:100

Maximum number of positions to return per page. Defaults to 100, maximum 100.

Required range: 1 <= x <= 100
Example:

100

​
pagination_key
string

Pagination key returned from previous request to fetch next page of results

Example:

"NjhlMGM4MDAtZDkwNi00YjMyLWEzOWMtYTRlMTk5MzRkNWVl"

Response

Positions response

​
wallet_address
string
required

The wallet address (normalized to lowercase)

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
positions
object[]
required

Array of position objects

​
pagination
object
required

Pagination information