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

# Get datatrades



## OpenAPI

````yaml /openapi.json get /data/trades
openapi: 3.0.3
info:
  title: Blink Markets API
  description: Trading API for Blink Prediction Markets
  contact:
    name: Blink
    url: https://blink15.com
  license:
    name: Proprietary
    url: https://blink15.com/terms
  version: 1.0.0
servers:
  - url: https://api.blink15.com
    description: Production (Base Sepolia Testnet)
  - url: http://localhost:3001
    description: Local Development
security: []
tags:
  - name: health
    description: Health check endpoints
  - name: markets
    description: Market discovery and information
  - name: market-data
    description: Orderbook, price, and spread data
  - name: trading
    description: Order placement, cancellation, and trade history
  - name: account
    description: Wallet status, balances, and allowances
  - name: auth
    description: API key creation and derivation (L1 EIP-712)
  - name: orders
    description: Order management
  - name: trades
    description: Trade history and fills
  - name: users
    description: User account management
  - name: faucet
    description: Testnet faucet and gasless relay endpoints
  - name: admin
    description: Administrative endpoints (requires API key)
  - name: compat
    description: Polymarket-compatible endpoints
paths:
  /data/trades:
    get:
      tags:
        - trading
      operationId: get_trades
      responses:
        '200':
          description: User's trade history with pagination cursor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TradesResponse'
        '401':
          description: HMAC authentication failed
      security:
        - hmac_signature: []
components:
  schemas:
    TradesResponse:
      type: object
      description: |-
        Get user's trades - GET /data/trades
        Matches Polymarket py-clob-client format (uses 'data' not 'trades')
      required:
        - data
        - next_cursor
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/TradeInfo'
          description: Array of trades (Polymarket uses 'data' not 'trades')
        next_cursor:
          type: string
          description: Pagination cursor for next page (Polymarket compatibility)
    TradeInfo:
      type: object
      description: >-
        Polymarket-compatible trade info (PolymarketTradeReport format)

        Required fields for Nautilus Trader: taker_order_id, maker_address,
        transaction_hash, maker_orders, trader_side
      required:
        - id
        - asset_id
        - price
        - size
        - side
        - taker_order_id
        - bucket_index
        - fee_rate_bps
        - market
        - maker_address
        - owner
        - outcome
        - match_time
        - status
        - last_update
        - transaction_hash
        - maker_orders
        - trader_side
      properties:
        asset_id:
          type: string
          description: Polymarket uses asset_id, not market_id
        bucket_index:
          type: integer
          format: int32
          description: Bucket index (for fee calculations)
        fee_rate_bps:
          type: string
          description: Fee rate in basis points (required by Nautilus)
        id:
          type: string
        last_update:
          type: string
          description: Last update timestamp (required by Nautilus Trader)
        maker_address:
          type: string
          description: Maker address (required by Nautilus)
        maker_orders:
          type: array
          items:
            $ref: '#/components/schemas/MakerOrderInfo'
          description: Maker orders (required by Nautilus)
        market:
          type: string
          description: Market/condition ID
        match_time:
          type: string
          description: Matched timestamp (epoch seconds as string)
        outcome:
          type: string
          description: 'Outcome: "Yes" or "No"'
        owner:
          type: string
          description: Owner address (the user's address)
        price:
          type: string
        side:
          type: string
        size:
          type: string
        status:
          type: string
          description: Trade status
        taker_order_id:
          type: string
          description: Required by Nautilus - order ID of the taker
        trader_side:
          type: string
          description: 'Trader side: "MAKER" or "TAKER" (required by Nautilus)'
        transaction_hash:
          type: string
          description: Transaction hash (required by Nautilus)
    MakerOrderInfo:
      type: object
      description: Polymarket-compatible maker order info (embedded in trades)
      required:
        - asset_id
        - fee_rate_bps
        - maker_address
        - matched_amount
        - order_id
        - outcome
        - owner
        - price
      properties:
        asset_id:
          type: string
        fee_rate_bps:
          type: string
        maker_address:
          type: string
        matched_amount:
          type: string
        order_id:
          type: string
        outcome:
          type: string
        owner:
          type: string
        price:
          type: string
  securitySchemes:
    hmac_signature:
      type: apiKey
      in: header
      name: BLINK-SIGNATURE

````