Skip to main content
GET
/
portfolio
/
{address}
Get portfolio positions
curl --request GET \
  --url https://api-testnet.context.markets/v2/portfolio/{address} \
  --header 'Authorization: Bearer <token>'
{
  "portfolio": [
    {
      "tokenAddress": "<string>",
      "balance": "<string>",
      "settlementBalance": "<string>",
      "walletBalance": "<string>",
      "outcomeIndex": 123,
      "outcomeName": "<string>",
      "marketId": "<string>",
      "netInvestment": "<string>",
      "currentValue": "<string>",
      "tokensRedeemed": "<string>"
    }
  ],
  "marketIds": [
    "<string>"
  ],
  "cursor": "<string>"
}

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Path Parameters

address
string
required

Ethereum address (0x-prefixed, 40 hex chars)

Query Parameters

marketId
string

Filter by market ID

kind
enum<string>

Filter by position type

Available options:
all,
active,
won,
lost,
claimable
cursor
string

Pagination cursor (blockNum|logIdx format)

pageSize
integer

Results per page

Required range: 1 <= x <= 50

Response

Portfolio positions

portfolio
object[]
required
marketIds
string[]
required
cursor
string | null
required