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

# 💼 Past 24 Hour Trades by Token Address

> This endpoint allows you to **query the last 300 trades in the past 24 hours, across all pools, based on the provided token contract address on a network**

<Note>
  ### Note

  * Exclusive for all [Paid Plan](https://www.coingecko.com/en/api/pricing) Subscribers (Analyst, Lite, Pro and Enterprise).
  * Cache / Update Frequency: Real-time (Cacheless) for Pro API (Analyst, Lite, Pro, Enterprise).
</Note>


## OpenAPI

````yaml api-reference/onchain-pro.json get /networks/{network}/tokens/{token_address}/trades
openapi: 3.0.0
info:
  title: Onchain DEX API (Pro)
  version: 3.0.0
servers:
  - url: https://pro-api.coingecko.com/api/v3/onchain
security:
  - apiKeyAuth: []
  - apiKeyQueryParam: []
paths:
  /networks/{network}/tokens/{token_address}/trades:
    get:
      tags:
        - Trades
      summary: 💼 Past 24 Hour Trades by Token Address
      description: >-
        This endpoint allows you to **query the last 300 trades in the past 24
        hours, across all pools, based on the provided token contract address on
        a network**
      operationId: token-trades-contract-address
      parameters:
        - name: network
          in: path
          description: |-
            network ID 
             *refers to [/networks](/reference/networks-list)
          required: true
          schema:
            type: string
            example: eth
            default: eth
        - name: token_address
          in: path
          description: token contract address
          required: true
          schema:
            type: string
            example: '0xdac17f958d2ee523a2206206994597c13d831ec7'
            default: '0xdac17f958d2ee523a2206206994597c13d831ec7'
        - name: trade_volume_in_usd_greater_than
          in: query
          required: false
          description: |-
            filter trades by trade volume in USD greater than this value 
             Default value: 0
          schema:
            type: number
      responses:
        '200':
          description: Get last 300 trades in past 24 hours from a token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenTrades'
components:
  schemas:
    TokenTrades:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
              attributes:
                type: object
                properties:
                  pool_address:
                    type: string
                  pool_dex:
                    type: string
                  block_number:
                    type: integer
                  tx_hash:
                    type: string
                  tx_from_address:
                    type: string
                  from_token_amount:
                    type: string
                  to_token_amount:
                    type: string
                  price_from_in_currency_token:
                    type: string
                  price_to_in_currency_token:
                    type: string
                  price_from_in_usd:
                    type: string
                  price_to_in_usd:
                    type: string
                  block_timestamp:
                    type: string
                  kind:
                    type: string
                  volume_in_usd:
                    type: string
                  from_token_address:
                    type: string
                  to_token_address:
                    type: string
      example:
        data:
          - id: >-
              eth_22294076_0x1ff33129a907411d2c5fff604a07d9d0b8ae9e73eaca9a1702548c8a6f9e4bad_71_1744957467
            type: trade
            attributes:
              pool_address: '0x06da0fd433c1a5d7a4faa01111c044910a184553'
              pool_dex: sushiswap
              block_number: 22294076
              tx_hash: >-
                0x1ff33129a907411d2c5fff604a07d9d0b8ae9e73eaca9a1702548c8a6f9e4bad
              tx_from_address: '0x30a6f82f360c3bedc46fc8780082bcbde194ba7c'
              from_token_amount: '7.988'
              to_token_amount: '0.00504351846703413'
              price_from_in_currency_token: '0.000631386888712335'
              price_to_in_currency_token: '1.0'
              price_from_in_usd: '0.997016722096761'
              price_to_in_usd: '1579.09'
              block_timestamp: '2025-04-18T06:24:23Z'
              kind: sell
              volume_in_usd: '7.96416957610893'
              from_token_address: '0xdac17f958d2ee523a2206206994597c13d831ec7'
              to_token_address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-cg-pro-api-key
    apiKeyQueryParam:
      type: apiKey
      in: query
      name: x_cg_pro_api_key

````