> ## 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.

# 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
  - url: https://api.staging.agg.market
    description: Staging
security: []
paths:
  /users/activity:
    get:
      tags:
        - Users
      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:
            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:
                              type: string
                            createdAt:
                              format: date-time
                              type: string
                            updatedAt:
                              format: date-time
                              type: string
                            status:
                              type: string
                            type:
                              type: string
                              enum:
                                - trade
                            venue:
                              type: string
                            side:
                              type: string
                            amountRaw:
                              type: string
                            filledAmountRaw:
                              type: string
                              nullable: true
                            executionPrice:
                              type: string
                              nullable: true
                            venueMarket:
                              type: object
                              required:
                                - id
                                - venueEventId
                                - question
                                - image
                              properties:
                                id:
                                  type: string
                                venueEventId:
                                  type: string
                                question:
                                  type: string
                                  nullable: true
                                image:
                                  type: string
                                  nullable: true
                              nullable: true
                            venueMarketOutcome:
                              type: object
                              required:
                                - id
                                - label
                                - title
                                - price
                              properties:
                                id:
                                  type: string
                                label:
                                  type: string
                                title:
                                  type: string
                                  nullable: true
                                price:
                                  type: number
                              nullable: true
                            txHash:
                              type: string
                              nullable: true
                            errorMessage:
                              type: string
                              nullable: true
                        - type: object
                          required:
                            - id
                            - createdAt
                            - updatedAt
                            - status
                            - type
                            - tokenSymbol
                            - amountRaw
                            - destinationAddress
                            - destinationChainId
                            - completedAmountRaw
                            - errorMessage
                          properties:
                            id:
                              type: string
                            createdAt:
                              format: date-time
                              type: string
                            updatedAt:
                              format: date-time
                              type: string
                            status:
                              type: string
                            type:
                              type: string
                              enum:
                                - withdrawal
                            tokenSymbol:
                              type: string
                            amountRaw:
                              type: string
                            destinationAddress:
                              type: string
                            destinationChainId:
                              type: string
                            completedAmountRaw:
                              type: string
                              nullable: true
                            chainId:
                              type: string
                              nullable: true
                            txHash:
                              type: string
                              nullable: true
                            errorMessage:
                              type: string
                              nullable: true
                        - type: object
                          required:
                            - id
                            - createdAt
                            - updatedAt
                            - status
                            - type
                            - tokenSymbol
                            - amountRaw
                            - sourceChainId
                            - destChainId
                            - sourceTxHash
                            - destTxHash
                          properties:
                            id:
                              type: string
                            createdAt:
                              format: date-time
                              type: string
                            updatedAt:
                              format: date-time
                              type: string
                            status:
                              type: string
                            type:
                              type: string
                              enum:
                                - bridge
                            tokenSymbol:
                              type: string
                            amountRaw:
                              type: string
                            sourceChainId:
                              type: string
                            destChainId:
                              type: string
                            sourceTxHash:
                              type: string
                              nullable: true
                            destTxHash:
                              type: string
                              nullable: true
                        - type: object
                          required:
                            - id
                            - createdAt
                            - updatedAt
                            - status
                            - type
                            - tokenSymbol
                            - amountRaw
                            - chainId
                            - fromAddress
                            - txHash
                            - source
                          properties:
                            id:
                              type: string
                            createdAt:
                              format: date-time
                              type: string
                            updatedAt:
                              format: date-time
                              type: string
                            status:
                              type: string
                            type:
                              type: string
                              enum:
                                - deposit
                            tokenSymbol:
                              type: string
                            amountRaw:
                              type: string
                            chainId:
                              type: string
                            fromAddress:
                              type: string
                            txHash:
                              type: string
                            source:
                              type: string
                              enum:
                                - connected_wallet
                                - external_wallet
                        - type: object
                          required:
                            - id
                            - createdAt
                            - updatedAt
                            - status
                            - type
                            - callsId
                            - chainId
                            - walletAddress
                            - txHash
                            - confirmedAt
                          properties:
                            id:
                              type: string
                            createdAt:
                              format: date-time
                              type: string
                            updatedAt:
                              format: date-time
                              type: string
                            status:
                              type: string
                            type:
                              type: string
                              enum:
                                - user_op
                            callsId:
                              type: string
                            chainId:
                              type: string
                            walletAddress:
                              type: string
                            txHash:
                              type: string
                              nullable: true
                            confirmedAt:
                              type: string
                              nullable: true
                        - type: object
                          required:
                            - id
                            - createdAt
                            - updatedAt
                            - status
                            - type
                            - totalPayoutRaw
                            - legs
                          properties:
                            id:
                              type: string
                            createdAt:
                              format: date-time
                              type: string
                            updatedAt:
                              format: date-time
                              type: string
                            status:
                              type: string
                            type:
                              type: string
                              enum:
                                - redeem
                            totalPayoutRaw:
                              type: string
                              nullable: true
                            legs:
                              type: array
                              items:
                                type: object
                                required:
                                  - id
                                  - venueMarketOutcomeId
                                  - venue
                                  - status
                                  - chainId
                                  - payoutTokenSymbol
                                  - payoutAmountRaw
                                  - txHash
                                  - errorMessage
                                  - venueMarket
                                  - venueMarketOutcome
                                properties:
                                  id:
                                    type: string
                                  venueMarketOutcomeId:
                                    type: string
                                  venue:
                                    type: string
                                  status:
                                    type: string
                                  chainId:
                                    type: string
                                  payoutTokenSymbol:
                                    type: string
                                  payoutAmountRaw:
                                    type: string
                                    nullable: true
                                  txHash:
                                    type: string
                                    nullable: true
                                  errorMessage:
                                    type: string
                                    nullable: true
                                  venueMarket:
                                    type: object
                                    required:
                                      - id
                                      - venueEventId
                                      - question
                                      - image
                                    properties:
                                      id:
                                        type: string
                                      venueEventId:
                                        type: string
                                      question:
                                        type: string
                                        nullable: true
                                      image:
                                        type: string
                                        nullable: true
                                    nullable: true
                                  venueMarketOutcome:
                                    type: object
                                    required:
                                      - id
                                      - label
                                      - title
                                    properties:
                                      id:
                                        type: string
                                      label:
                                        type: string
                                      title:
                                        type: string
                                        nullable: true
                                    nullable: true
                  nextCursor:
                    type: string
                    nullable: true
                  hasMore:
                    type: boolean
        '401':
          description: '401'
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
        '403':
          description: '403'
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
      security:
        - appId: []
          bearerAuth: []
components:
  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.

````