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
  }
}

Documentation Index

Fetch the complete documentation index at: https://aisa.one/docs/llms.txt

Use this file to discover all available pages before exploring further.

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