get_tokens_networks_onchain_trades

Query the last 300 trades in the past 24 hours for a specific token contract address on a network, using the jq_filter parameter to optimize response size and performance.

Instructions

When using this tool, always use the jq_filter parameter to reduce the response size and improve performance.

Only omit if you're sure you don't need the data.

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

Response Schema

{
  type: 'object',
  properties: {
    data: {
      type: 'array',
      items: {
        type: 'object',
        properties: {
          id: {
            type: 'string'
          },
          attributes: {
            type: 'object',
            properties: {
              block_number: {
                type: 'integer'
              },
              block_timestamp: {
                type: 'string'
              },
              from_token_address: {
                type: 'string'
              },
              from_token_amount: {
                type: 'string'
              },
              kind: {
                type: 'string'
              },
              pool_address: {
                type: 'string'
              },
              pool_dex: {
                type: 'string'
              },
              price_from_in_currency_token: {
                type: 'string'
              },
              price_from_in_usd: {
                type: 'string'
              },
              price_to_in_currency_token: {
                type: 'string'
              },
              price_to_in_usd: {
                type: 'string'
              },
              to_token_address: {
                type: 'string'
              },
              to_token_amount: {
                type: 'string'
              },
              tx_from_address: {
                type: 'string'
              },
              tx_hash: {
                type: 'string'
              },
              volume_in_usd: {
                type: 'string'
              }
            }
          },
          type: {
            type: 'string'
          }
        }
      }
    }
  }
}

Input Schema

Name	Required	Description
`jq_filter`	No	A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available. For example: to include only the `name` field in every object of a results array, you can provide ".results[].name". For more information, see the [jq documentation](https://jqlang.org/manual/).
`network`	Yes
`token_address`	Yes
`trade_volume_in_usd_greater_than`	No	filter trades by trade volume in USD greater than this value <br> Default value: 0

Input Schema (JSON Schema)

{
  "properties": {
    "jq_filter": {
      "description": "A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide \".results[].name\".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).",
      "title": "jq Filter",
      "type": "string"
    },
    "network": {
      "type": "string"
    },
    "token_address": {
      "type": "string"
    },
    "trade_volume_in_usd_greater_than": {
      "description": "filter trades by trade volume in USD greater than this value <br> Default value: 0",
      "type": "number"
    }
  },
  "required": [
    "network",
    "token_address"
  ],
  "type": "object"
}

CoinGecko MCP Server

get_tokens_networks_onchain_trades

Instructions

Response Schema

Input Schema

Input Schema (JSON Schema)

Other Tools from CoinGecko MCP Server

Related Tools

MCP directory API