Skip to main content
GET
Error

Authorizations

aura_session
string
cookie
required

HttpOnly session cookie set by POST /v1/auth/session. Mutating requests must also send the CSRF token (returned by that call) in the x-csrf-token header.

Path Parameters

address
string
required

Alephium address (base58, optional :N group suffix).

Required string length: 30 - 80
Pattern: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$

Query Parameters

marketId
integer
Required range: x <= 9007199254740991
settled

Filter by settlement state.

profitable

When true, require potentialPayout > 0; false requires potentialPayout <= 0.

limit
integer
default:100
Required range: 1 <= x <= 200
cursor
string
page
integer
Required range: 0 <= x <= 9007199254740991

Response

Default Response

positions
object[]
required
pagination
object
required

Pagination envelope returned alongside every list endpoint.

Last modified on August 11, 2026