Skip to main content
GET
/
v1
/
users
/
{address}
/
positions
Error
A valid request URL is required to generate request examples
{
  "positions": [
    {
      "id": 0,
      "userAddress": "<string>",
      "marketId": 0,
      "positionType": "yes",
      "shares": "<string>",
      "entryPrice": 500,
      "potentialPayout": "<string>",
      "isSettled": true,
      "lockedCollateral": "<string>",
      "lockedShares": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "pagination": {
    "limit": 100,
    "nextCursor": "<string>",
    "page": 4503599627370495,
    "total": 4503599627370495
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.aura.markets/llms.txt

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

Authorizations

Authorization
string
header
required

API key obtained from POST /v1/auth/keys.

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
boolean

Filter by settlement state.

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.