> ## Documentation Index > Fetch the complete documentation index at: https://docs.agg.market/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > To integrate AGG, start with Quickstart: REST (https://docs.agg.market/quickstart/rest), then Order lifecycle & statuses (https://docs.agg.market/concepts/order-lifecycle). > Track every trade until it reaches a terminal status. Before retrying a failed or timed-out call, read Errors, retries & idempotency (https://docs.agg.market/concepts/errors). > The API reference is generated from https://docs.agg.market/openapi/openapi.json. # Get user activity feed > Returns a unified, timestamp-ordered feed of the authenticated user's trades, withdrawals, standalone bridges, deposits, and low-level wallet operations. Cursor-based pagination. ## OpenAPI ````yaml /openapi/openapi.json get /users/activity openapi: 3.0.2 info: title: AGG API version: 1.0.0 description: >- Prediction market aggregator REST API — authentication, users, venue events, venue markets, orderbooks, charts, and execution workflows. servers: - url: https://api.agg.market description: Production security: [] tags: - name: Authentication description: Sign users in and manage their session tokens. - name: Markets description: Find events, markets and outcomes to trade. - name: Market Data description: Live orderbooks, prices, charts and scores for those markets. - name: Trading description: Quote, place, sign, track and cancel orders. - name: Portfolio description: A user's orders, positions, balances and activity. - name: Funding description: Deposit addresses, withdrawals, balance refills and fiat on-ramp. - name: Users description: The signed-in user's profile, linked accounts, KYC and venue keys. - name: Hosted Venue Accounts description: Provision, fund and withdraw from venue accounts hosted for the user. - name: Webhooks description: Configure and operate webhook delivery to your server. - name: Partner Admin description: Server-side reads across your app's users, orders and analytics. - name: Paper Trading description: Simulated accounts and orders for testing without real funds. - name: News description: News feeds linked to markets. - name: Correlated Markets description: Markets related to a given market and the effect of its resolution. paths: /users/activity: get: tags: - Portfolio summary: Get user activity feed description: >- Returns a unified, timestamp-ordered feed of the authenticated user's trades, withdrawals, standalone bridges, deposits, and low-level wallet operations. Cursor-based pagination. operationId: getActivity parameters: - name: type in: query required: false schema: description: >- Kind of activity: `trade` an order, `withdrawal`, `bridge` a cross-chain transfer, `deposit`, `user_op` a wallet operation, `redeem` a winnings claim. type: string enum: - trade - withdrawal - bridge - deposit - user_op - redeem - name: cursor in: query required: false schema: type: string - name: limit in: query required: false schema: minimum: 1 maximum: 100 type: integer responses: '200': description: '200' content: application/json: schema: type: object required: - data - nextCursor - hasMore properties: data: type: array items: anyOf: - type: object required: - id - createdAt - updatedAt - status - type - venue - side - amountRaw - filledAmountRaw - executionPrice - venueMarket - venueMarketOutcome - txHash - errorMessage properties: id: description: Id of the underlying order, transfer or claim. type: string createdAt: format: date-time description: Creation time. type: string updatedAt: format: date-time description: Time of the last change. type: string status: description: >- Status; the value set depends on `type`. `trade`: an order status (`pending`, `submitted`, `filled`, `partial_fill`, `failed`, `cancelled`, …; see OrderStatus). `withdrawal`: `pending`, `bridging`, `transferring`, `completed`, `partial`, `failed`. `bridge`: `pending`, `depositing`, `confirming`, `completed`, `failed`, `refunded`. `deposit`: `pending` or `confirmed`. `user_op`: `pending`, `confirmed`, `failed`. `redeem`: `pending`, `confirmed`, `failed`, `rejected`, `partial`. type: string type: description: Always `trade`. type: string enum: - trade venue: description: >- Venue the order ran on (one of the Venue values, e.g. `polymarket`, `kalshi`). type: string side: description: '`buy` or `sell`.' type: string amountRaw: description: >- Order amount, as on GET /execution/orders: USD in 6-decimal atomic units (1000000 = $1) for market orders and limit buys; shares in 6-decimal atomic units for limit sells. type: string filledAmountRaw: description: >- USD actually filled (cost on a buy, proceeds on a sell), in 6-decimal atomic units. type: string nullable: true executionPrice: description: >- Average fill price per share from 0 to 1, as a decimal string (e.g. "0.53"). type: string nullable: true venueMarket: description: The market. type: object required: - id - venueEventId - question - image properties: id: description: Market id. type: string venueEventId: description: Event id. type: string question: description: Market question. type: string nullable: true image: description: Image URL. type: string nullable: true nullable: true venueMarketOutcome: type: object required: - id - label - title - price properties: id: description: Outcome id. type: string label: description: Outcome label, e.g. "Yes". type: string title: description: Longer outcome title, if any. type: string nullable: true price: description: Current price of the outcome, 0 to 1. type: number nullable: true txHash: description: Transaction hash, once known. type: string nullable: true errorMessage: description: Readable failure reason. type: string nullable: true - type: object required: - id - createdAt - updatedAt - status - type - tokenSymbol - amountRaw - destinationAddress - destinationChainId - completedAmountRaw - errorMessage properties: id: description: Id of the underlying order, transfer or claim. type: string createdAt: format: date-time description: Creation time. type: string updatedAt: format: date-time description: Time of the last change. type: string status: description: >- Status; the value set depends on `type`. `trade`: an order status (`pending`, `submitted`, `filled`, `partial_fill`, `failed`, `cancelled`, …; see OrderStatus). `withdrawal`: `pending`, `bridging`, `transferring`, `completed`, `partial`, `failed`. `bridge`: `pending`, `depositing`, `confirming`, `completed`, `failed`, `refunded`. `deposit`: `pending` or `confirmed`. `user_op`: `pending`, `confirmed`, `failed`. `redeem`: `pending`, `confirmed`, `failed`, `rejected`, `partial`. type: string type: description: Always `withdrawal`. type: string enum: - withdrawal tokenSymbol: description: Token moved, e.g. "USDC". type: string amountRaw: description: >- Amount withdrawn. Integer string in the token's atomic units (6 decimals for USDC, so 1000000 = 1 USDC; 18 on BNB Chain). type: string destinationAddress: description: Recipient address. type: string destinationChainId: description: Delivery chain id, as a decimal string. type: string completedAmountRaw: description: >- Amount delivered, once terminal. Integer string in the token's atomic units (6 decimals for USDC, so 1000000 = 1 USDC; 18 on BNB Chain). type: string nullable: true chainId: description: Chain id, as a decimal string. type: string nullable: true txHash: description: Transaction hash, once known. type: string nullable: true errorMessage: description: Readable failure reason. type: string nullable: true - type: object required: - id - createdAt - updatedAt - status - type - tokenSymbol - amountRaw - sourceChainId - destChainId - sourceTxHash - destTxHash properties: id: description: Id of the underlying order, transfer or claim. type: string createdAt: format: date-time description: Creation time. type: string updatedAt: format: date-time description: Time of the last change. type: string status: description: >- Status; the value set depends on `type`. `trade`: an order status (`pending`, `submitted`, `filled`, `partial_fill`, `failed`, `cancelled`, …; see OrderStatus). `withdrawal`: `pending`, `bridging`, `transferring`, `completed`, `partial`, `failed`. `bridge`: `pending`, `depositing`, `confirming`, `completed`, `failed`, `refunded`. `deposit`: `pending` or `confirmed`. `user_op`: `pending`, `confirmed`, `failed`. `redeem`: `pending`, `confirmed`, `failed`, `rejected`, `partial`. type: string type: description: Always `bridge`. type: string enum: - bridge tokenSymbol: description: Token moved, e.g. "USDC". type: string amountRaw: description: >- Amount bridged. Integer string in the token's atomic units (6 decimals for USDC, so 1000000 = 1 USDC; 18 on BNB Chain). type: string sourceChainId: description: Chain bridged from, as a decimal string. type: string destChainId: description: Chain bridged to, as a decimal string. type: string sourceTxHash: description: Transaction on the source chain. type: string nullable: true destTxHash: description: Transaction on the destination chain. type: string nullable: true - type: object required: - id - createdAt - updatedAt - status - type - tokenSymbol - amountRaw - chainId - fromAddress - txHash - source properties: id: description: Id of the underlying order, transfer or claim. type: string createdAt: format: date-time description: Creation time. type: string updatedAt: format: date-time description: Time of the last change. type: string status: description: >- Status; the value set depends on `type`. `trade`: an order status (`pending`, `submitted`, `filled`, `partial_fill`, `failed`, `cancelled`, …; see OrderStatus). `withdrawal`: `pending`, `bridging`, `transferring`, `completed`, `partial`, `failed`. `bridge`: `pending`, `depositing`, `confirming`, `completed`, `failed`, `refunded`. `deposit`: `pending` or `confirmed`. `user_op`: `pending`, `confirmed`, `failed`. `redeem`: `pending`, `confirmed`, `failed`, `rejected`, `partial`. type: string type: description: Always `deposit`. type: string enum: - deposit tokenSymbol: description: Token moved, e.g. "USDC". type: string amountRaw: description: >- Amount deposited. Integer string in the token's atomic units (6 decimals for USDC, so 1000000 = 1 USDC; 18 on BNB Chain). type: string chainId: description: Chain id, as a decimal string. type: string fromAddress: description: Address the deposit came from. type: string txHash: description: Deposit transaction hash. type: string source: description: >- `connected_wallet`: sent from a wallet linked to the account. `external_wallet`: sent from any other address. type: string enum: - connected_wallet - external_wallet - type: object required: - id - createdAt - updatedAt - status - type - callsId - chainId - walletAddress - txHash - confirmedAt properties: id: description: Id of the underlying order, transfer or claim. type: string createdAt: format: date-time description: Creation time. type: string updatedAt: format: date-time description: Time of the last change. type: string status: description: >- Status; the value set depends on `type`. `trade`: an order status (`pending`, `submitted`, `filled`, `partial_fill`, `failed`, `cancelled`, …; see OrderStatus). `withdrawal`: `pending`, `bridging`, `transferring`, `completed`, `partial`, `failed`. `bridge`: `pending`, `depositing`, `confirming`, `completed`, `failed`, `refunded`. `deposit`: `pending` or `confirmed`. `user_op`: `pending`, `confirmed`, `failed`. `redeem`: `pending`, `confirmed`, `failed`, `rejected`, `partial`. type: string type: description: Always `user_op`. type: string enum: - user_op callsId: description: Id of the wallet operation. type: string chainId: description: Chain id, as a decimal string. type: string walletAddress: description: Wallet that ran the operation. type: string txHash: description: Transaction hash, once known. type: string nullable: true confirmedAt: description: ISO-8601 confirmation time. type: string nullable: true - type: object required: - id - createdAt - updatedAt - status - type - totalPayoutRaw - legs properties: id: description: Id of the underlying order, transfer or claim. type: string createdAt: format: date-time description: Creation time. type: string updatedAt: format: date-time description: Time of the last change. type: string status: description: >- Status; the value set depends on `type`. `trade`: an order status (`pending`, `submitted`, `filled`, `partial_fill`, `failed`, `cancelled`, …; see OrderStatus). `withdrawal`: `pending`, `bridging`, `transferring`, `completed`, `partial`, `failed`. `bridge`: `pending`, `depositing`, `confirming`, `completed`, `failed`, `refunded`. `deposit`: `pending` or `confirmed`. `user_op`: `pending`, `confirmed`, `failed`. `redeem`: `pending`, `confirmed`, `failed`, `rejected`, `partial`. type: string type: description: Always `redeem`. type: string enum: - redeem totalPayoutRaw: description: >- Total payout across legs. Integer string in the token's atomic units (6 decimals for USDC, so 1000000 = 1 USDC; 18 on BNB Chain). type: string nullable: true legs: description: One entry per outcome claimed. type: array items: type: object required: - id - venueMarketOutcomeId - venue - status - chainId - payoutTokenSymbol - payoutAmountRaw - txHash - errorMessage - venueMarket - venueMarketOutcome properties: id: description: Claim leg id. type: string venueMarketOutcomeId: description: Outcome claimed. type: string venue: description: >- Venue of the claimed position (one of the Venue values, e.g. `polymarket`, `limitless`). type: string status: description: >- Claim status: `pending`, `confirmed`, `failed`, `rejected` or `partial`. type: string chainId: description: Chain id, as a decimal string. type: string payoutTokenSymbol: description: >- Token the payout arrives in. Open set, e.g. `USDC`, `USDC.e`, `pUSD`. type: string payoutAmountRaw: description: >- Payout of this leg, in `payoutTokenSymbol`. Integer string in the token's atomic units (6 decimals for USDC, so 1000000 = 1 USDC; 18 on BNB Chain). type: string nullable: true txHash: description: Transaction hash, once known. type: string nullable: true errorMessage: description: Readable failure reason. type: string nullable: true venueMarket: description: The market. type: object required: - id - venueEventId - question - image properties: id: description: Market id. type: string venueEventId: description: Event id. type: string question: description: Market question. type: string nullable: true image: description: Image URL. type: string nullable: true nullable: true venueMarketOutcome: type: object required: - id - label - title properties: id: description: Outcome id. type: string label: description: Outcome label, e.g. "Yes". type: string title: description: Longer outcome title, if any. type: string nullable: true nullable: true nextCursor: type: string nullable: true hasMore: type: boolean '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' security: - appId: [] bearerAuth: [] components: schemas: ErrorMessage: type: object required: - message properties: message: type: string securitySchemes: appId: type: apiKey in: header name: x-app-id description: Your application ID. Required for all app-tier and user-tier routes. bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT access token returned by POST /auth/verify. Required for user-tier routes. ````