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

# List trades

> Fills newest first, in the advertised pair orientation. On USDCcNGN-SPOT, price is cNGN per USDC, base_volume is USDC and target_volume is cNGN. Responses are cached for up to 5 seconds and carry Cache-Control: public, max-age=5, so polling faster than that returns the same data.



## OpenAPI

````yaml GET /v1/integrations/trades
openapi: 3.1.0
info:
  title: Numo orderbook API
  description: >-
    REST endpoints exposed by Numo's markets-service and execution-service for
    dollar stablecoins. Real-time book, trades, and order streams are served
    over the WebSocket endpoint documented in the WebSocket streams reference.
  version: 1.0.0
servers:
  - url: https://api.numofx.com
    description: markets-service
  - url: https://executor.numofx.com
    description: execution-service
security: []
tags:
  - name: Markets service
  - name: Execution service
paths:
  /v1/integrations/trades:
    get:
      tags:
        - Markets service
      summary: List trades for integrators
      description: >-
        Fills newest first, in the advertised pair orientation. On
        USDCcNGN-SPOT, price is cNGN per USDC, base_volume is USDC and
        target_volume is cNGN. Responses are cached for up to 5 seconds and
        carry Cache-Control: public, max-age=5, so polling faster than that
        returns the same data.
      operationId: listIntegrationTrades
      parameters:
        - name: ticker_id
          in: query
          required: true
          schema:
            type: string
          description: >-
            A ticker_id from GET /v1/integrations/tickers, such as
            USDCcNGN-SPOT.
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 100
        - name: before_trade_id
          in: query
          schema:
            type: integer
            minimum: 1
          description: >-
            The next_before_trade_id from the previous page, to page to older
            trades.
      responses:
        '200':
          description: One page of trades, newest first
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationTradesResponse'
        '400':
          description: Missing or unknown ticker_id, or an invalid limit or before_trade_id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    IntegrationTradesResponse:
      type: object
      required:
        - ticker_id
        - trades
      properties:
        ticker_id:
          type: string
        trades:
          type: array
          items:
            $ref: '#/components/schemas/IntegrationTrade'
        next_before_trade_id:
          type: integer
          description: >-
            Pass as before_trade_id to fetch older trades. Absent on the last
            page.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
    IntegrationTrade:
      type: object
      required:
        - trade_id
        - price
        - base_volume
        - target_volume
        - trade_timestamp
        - type
      properties:
        trade_id:
          type: integer
          description: The same trade_id GET /v1/trades reports.
        price:
          type: string
          description: target_currency per base_currency. cNGN per USDC on USDCcNGN-SPOT.
        base_volume:
          type: string
          description: Base asset traded. USDC on USDCcNGN-SPOT.
        target_volume:
          type: string
          description: Target asset traded. cNGN on USDCcNGN-SPOT.
        trade_timestamp:
          type: integer
          description: Unix milliseconds.
        type:
          type: string
          enum:
            - buy
            - sell
          description: 'The taker''s side in the base asset: buy means the taker acquired it.'

````