List account positions | Predict API Documentation

{
  "data": [
    {
      "outcome_id": "string",
      "side": 1,
      "quantity": "string",
      "average_entry_price": "string",
      "gross_realized_pnl_usdc": "string",
      "fees_paid_usdc": "string",
      "realized_pnl_usdc": "string",
      "mark_price": "string",
      "value_usdc": "string",
      "unrealized_pnl_usdc": "string",
      "total_pnl_usdc": "string",
      "account": {
        "main_account": {
          "address": "string",
          "username": "string",
          "image_url": "string",
          "hyperliquid_name": "string",
          "account_type": "main"
        },
        "subaccount": {
          "address": "string",
          "username": "string",
          "image_url": "string",
          "hyperliquid_name": "string",
          "account_type": "main"
        }
      },
      "opened_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "string",
  "as_of": "2024-01-15T09:30:00Z",
  "included": {
    "outcomes": [
      {
        "id": "string",
        "slug": "string",
        "event_id": "string",
        "title": "string",
        "status": "active",
        "hl_question_id": "string",
        "hl_id": "string",
        "created_at": "2024-01-15T09:30:00Z",
        "updated_at": "2024-01-15T09:30:00Z",
        "hl_template_id": "string",
        "hl_keywords": {},
        "hl_settle_fraction": "string",
        "hl_rules": "string",
        "question_id": "string",
        "settlement_initiated_at": "2024-01-15T09:30:00Z",
        "settlement_approved_at": "2024-01-15T09:30:00Z",
        "settled_at": "2024-01-15T09:30:00Z",
        "settlement": [
          {
            "side": 1,
            "fraction": "string"
          }
        ],
        "hl_settlement": [
          {
            "side": 1,
            "fraction": "string"
          }
        ],
        "sides": [
          {
            "side": 1,
            "label": "string",
            "abbreviation": "string",
            "participant_id": "string",
            "hl_asset_id": "string"
          }
        ],
        "trading": {
          "quote": "string",
          "min_notional": "string",
          "tick_size": "string",
          "lot_size": "string"
        },
        "providers": [
          {
            "provider": "string",
            "id": "string"
          }
        ],
        "sports_market": {
          "type": "SPORTS_MARKET_TYPE_UNSPECIFIED",
          "period": "SPORTS_MARKET_PERIOD_UNSPECIFIED",
          "line": "string"
        },
        "price_target": {
          "asset": "string",
          "comparator": "above",
          "strike": "string"
        },
        "participant_id": "string"
      }
    ],
    "events": [
      {
        "id": "string",
        "slug": "string",
        "title": "string",
        "start_time": "2024-01-15T09:30:00Z",
        "status": "active",
        "created_at": "2024-01-15T09:30:00Z",
        "updated_at": "2024-01-15T09:30:00Z",
        "image_url": "string",
        "topic_id": "string",
        "category": {
          "id": "string",
          "name": "string",
          "image_url": "string"
        },
        "series": {
          "id": "string",
          "name": "string",
          "image_url": "string"
        },
        "providers": [
          {
            "provider": "string",
            "id": "string"
          }
        ],
        "outcomes": [
          {
            "id": "string",
            "slug": "string",
            "event_id": "string",
            "title": "string",
            "status": "active",
            "hl_question_id": "string",
            "hl_id": "string",
            "created_at": "2024-01-15T09:30:00Z",
            "updated_at": "2024-01-15T09:30:00Z",
            "hl_template_id": "string",
            "hl_keywords": {},
            "hl_settle_fraction": "string",
            "hl_rules": "string",
            "question_id": "string",
            "settlement_initiated_at": "2024-01-15T09:30:00Z",
            "settlement_approved_at": "2024-01-15T09:30:00Z",
            "settled_at": "2024-01-15T09:30:00Z",
            "settlement": [
              {
                "side": 1,
                "fraction": "string"
              }
            ],
            "hl_settlement": [
              {
                "side": 1,
                "fraction": "string"
              }
            ],
            "sides": [
              {
                "side": 1,
                "label": "string",
                "abbreviation": "string",
                "participant_id": "string",
                "hl_asset_id": "string"
              }
            ],
            "trading": {
              "quote": "string",
              "min_notional": "string",
              "tick_size": "string",
              "lot_size": "string"
            },
            "providers": [
              {
                "provider": "string",
                "id": "string"
              }
            ],
            "sports_market": {
              "type": "SPORTS_MARKET_TYPE_UNSPECIFIED",
              "period": "SPORTS_MARKET_PERIOD_UNSPECIFIED",
              "line": "string"
            },
            "price_target": {
              "asset": "string",
              "comparator": "above",
              "strike": "string"
            },
            "participant_id": "string"
          }
        ],
        "questions": [
          {
            "id": "string",
            "event_id": "string",
            "hl_question_id": "string",
            "hl_fallback_outcome_id": "string",
            "hl_template_id": "string",
            "hl_keywords": {},
            "hl_rules": "string",
            "deployer_fee_scale": "string"
          }
        ],
        "settlement_initiated_at": "2024-01-15T09:30:00Z",
        "settlement_approved_at": "2024-01-15T09:30:00Z",
        "settled_at": "2024-01-15T09:30:00Z",
        "participants": [
          {
            "id": "string",
            "name": "string",
            "abbreviation": "string",
            "image_url": "string",
            "color": "string",
            "side": 1
          }
        ],
        "contest": {
          "status": "CONTEST_STATUS_UNSPECIFIED",
          "started_at": "2024-01-15T09:30:00Z",
          "ended_at": "2024-01-15T09:30:00Z"
        }
      }
    ]
  }
}

List the current open Predict outcome positions owned by a master account and its subaccounts, or by one exact subaccount address.

Path parameters

addressstringRequired

EVM wallet address encoded as a 0x-prefixed hexadecimal string.

Query parameters

outcome_idstringOptional

Stable unique identifier for the outcome.

limitintegerOptional

cursorstringOptional

Opaque pagination cursor returned by the previous page.

includeenumOptional

Optional related catalog resource. Omit for the smallest response.

Allowed values:

Response

datalist of objectsOptional

next_cursorstringOptional

Opaque pagination cursor returned by the previous page.

as_ofdatetimeOptional

includedobjectOptional

Related catalog resources requested with include=outcome or include=event. Collection responses deduplicate them by id instead of repeating the same event or outcome on every activity row.

Errors

400

Bad Request Error

404

Not Found Error

405

Method Not Allowed Error

500

Internal Server Error

503

Service Unavailable Error