List account activity | Predict API Documentation

{
  "data": [
    {
      "activity_id": "string",
      "type": "trade",
      "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"
        }
      },
      "outcome_id": "string",
      "side": 1,
      "direction": "string",
      "price": "string",
      "quantity": "string",
      "notional_usdc": "string",
      "fee_usdc": "string",
      "asset": "string",
      "amount": "string",
      "transaction_hash": "string",
      "from": {
        "address": "string",
        "username": "string",
        "image_url": "string",
        "hyperliquid_name": "string",
        "account_type": "main"
      },
      "to": {
        "address": "string",
        "username": "string",
        "image_url": "string",
        "hyperliquid_name": "string",
        "account_type": "main"
      },
      "occurred_at": "2024-01-15T09:30:00Z"
    }
  ],
  "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 a unified account timeline of trading, conversion, settlement, and transfer activity with optional type and outcome filters.

Path parameters

addressstringRequired

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

Query parameters

typeenumOptional

Allowed value for type.

outcome_idstringOptional

Stable unique identifier for the outcome.

limitintegerOptional

cursorstringOptional

Opaque pagination cursor returned by the previous page.

includeenumOptional

Optional related catalog resource. Rows without an outcome are unaffected.

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