List account trades | Predict API Documentation

{
  "data": [
    {
      "fill_id": "string",
      "trade_id": "string",
      "outcome_id": "string",
      "side": 1,
      "direction": "buy",
      "price": "string",
      "quantity": "string",
      "notional_usdc": "string",
      "fee_token": "string",
      "fee_amount": "string",
      "fee_usdc": "string",
      "gross_realized_pnl_usdc": "string",
      "realized_pnl_usdc": "string",
      "venue_order_id": "string",
      "transaction_hash": "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"
        }
      },
      "occurred_at": "2024-01-15T09:30:00Z",
      "submitted_by": {
        "address": "string",
        "username": "string",
        "image_url": "string",
        "hyperliquid_name": "string",
        "account_type": "main"
      },
      "client_order_id": "string",
      "liquidity": "maker"
    }
  ],
  "next_cursor": "string",
  "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 newest Predict fills for an account with optional outcome and submitting-wallet filters plus cursor pagination.

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.

submitted_bystringOptional

includeenumOptional

Optional related catalog resource. Omit for the smallest response.

Allowed values:

start_timedatetimeOptional

Inclusive lower bound on occurred_at. Not Event.start_time.

end_timedatetimeOptional

Inclusive upper bound on occurred_at. Not Event.start_time.

Response

datalist of objectsOptional

next_cursorstringOptional

Opaque pagination cursor returned by the previous page.

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