> ## Documentation Index
> Fetch the complete documentation index at: https://docs.limitless.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Trades

> Retrieve all AMM trades executed by the authenticated user



## OpenAPI

````yaml GET /portfolio/trades
openapi: 3.0.0
info:
  title: Limitless Exchange API
  description: >-
    Production-ready REST API for prediction market trading, portfolio
    management, and market data on Limitless Exchange (Base L2).
  version: '1.0'
  contact:
    name: API Support
    url: https://limitless.exchange
    email: help@limitless.network
servers:
  - url: https://api.limitless.exchange
    description: Production API
security: []
tags:
  - name: Authentication
    description: User authentication and session management
  - name: Markets
    description: Browse, search, and analyze prediction markets
  - name: Market Navigation
    description: Navigation tree, market pages, and property filters
  - name: Trading
    description: Create, manage, and cancel orders
  - name: Portfolio
    description: Position tracking, trade history, and performance
  - name: API Tokens
    description: Scoped API token management for partner integrations
  - name: Partner Accounts
    description: Sub-account creation and allowance recovery for partner integrations
  - name: System
    description: Public API state and availability information
paths:
  /portfolio/trades:
    get:
      tags:
        - Portfolio
      summary: Get Trades
      description: Retrieve all AMM trades executed by the authenticated user
      operationId: PortfolioController_getTrades
      parameters: []
      responses:
        '200':
          description: List of user trades with details
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HistoryTradeDto'
        '401':
          description: Unauthorized
      security:
        - HmacAuth: []
components:
  schemas:
    HistoryTradeDto:
      type: object
      description: An AMM trade executed by the user
      properties:
        blockTimestamp:
          type: string
          description: Timestamp of the block containing the trade
          example: '2025-09-01T11:30:31.000Z'
        collateralAmount:
          type: string
          description: Collateral amount traded (in token decimals)
          example: '5000000'
        market:
          type: object
          description: Market details for the trade
          properties:
            conditionId:
              type: string
              example: 0x812f578437dc...
            expirationDate:
              type: string
              example: Sep 1, 2025
            id:
              type: string
              example: 0x76d3e2098Be6...
            slug:
              type: string
              example: doge-above-021-sep-1
            title:
              type: string
              example: $DOGE above $0.21652 on Sep 1?
        outcomeIndex:
          type: number
          description: Index of the outcome traded (0 = YES, 1 = NO)
          example: 0
        outcomeTokenAmount:
          type: string
          description: Amount of outcome tokens traded
          example: '10000000'
        outcomeTokenAmounts:
          type: array
          description: Collateral per outcome token
          items:
            type: string
          example:
            - '5000000'
            - '0'
        outcomeTokenNetCost:
          type: string
          description: Net cost of the outcome tokens
          example: '4950000'
        outcomeTokenPrice:
          type: string
          description: Price of the outcome token at trade time
          example: '0.50'
        strategy:
          type: string
          description: Trade direction
          enum:
            - Buy
            - Sell
          example: Buy
        transactionHash:
          type: string
          description: On-chain transaction hash
          example: 0xabc123...
      required:
        - blockTimestamp
        - market
        - outcomeIndex
        - outcomeTokenAmounts
        - outcomeTokenNetCost
        - transactionHash
  securitySchemes:
    HmacAuth:
      type: apiKey
      in: header
      name: lmts-api-key
      description: >-
        Scoped API token with HMAC-SHA256 signing. Requires three headers:
        lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature
        (Base64-encoded HMAC). See Authentication docs for details.

````