--- agentTools: projectIndex: https://web3-shards.readme.io/llms.txt --- # /txns/trades/token Returns a list of parsed DEX trades for all transactions on a token across all of its pools. ```javascript "use strict"; const Shards = require("web3-shards"); const shards = Shards.API.Ethereum.V1; shards.configure({ apiKey: "YOUR_API_KEY", // Join the discord to get your api key. https://discord.com/invite/kJd8W7Nh7e maxRequestsPerSecond:5, // client-side limiter to prevent accidental burning logger: 1 // 0=none,1=errors,2=verbose }); const getTradesOnToken = async function() { const token = "0x6982508145454ce325ddbe47a25d4ec3d2311933"; const page = 1; const origin = "0xba01a8f92d0226beb53adf9fbea4088dd8c89a31"; const startTime = 1690610183; const endTime = 1692647843; const resp = await shards.transactions.getTradesOnToken(token, page, origin, startTime, endTime); console.log(resp) } getTradesOnToken(); ``` # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Shards API V1", "version": "1.0" }, "servers": [ { "url": "https://api.web3shards.io/v1" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "x-default": "db2f88b1-21cd-440b-9e8c-486a8688e34e", "name": "X-Api-Key" } } }, "security": [ { "sec0": [] } ], "paths": { "/txns/trades/token": { "get": { "summary": "/txns/trades/token", "description": "Returns a list of parsed DEX trades for all transactions on a token across all of its pools.", "operationId": "txns-trades-token", "parameters": [ { "name": "address", "in": "query", "description": "The token address with which to search DEX trades.", "required": true, "schema": { "type": "string", "default": "0x6982508145454ce325ddbe47a25d4ec3d2311933" } }, { "name": "origin", "in": "query", "description": "The original sender address of the transaction. Ignore this field if you want all trades.", "schema": { "type": "string", "default": "0xba01a8f92d0226beb53adf9fbea4088dd8c89a31" } }, { "name": "X-Api-Key", "in": "header", "schema": { "type": "string", "default": "db2f88b1-21cd-440b-9e8c-486a8688e34e" } }, { "name": "starttime", "in": "query", "description": "The epoch time seconds from which trades are searched.", "schema": { "type": "integer", "format": "int32", "default": 1690610183 } }, { "name": "endtime", "in": "query", "description": "The epoch time seconds to which trades are searched.", "schema": { "type": "integer", "format": "int32", "default": 1692647843 } }, { "name": "page", "in": "query", "description": "The page from which trades are queried. Max page size is 200.", "schema": { "type": "integer", "format": "int32", "default": 1 } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"statusCode\": 200,\n \"pageSize\": 9,\n \"nextPage\": null,\n \"prevPage\": null,\n \"trades\": [\n {\n \"tx\": \"0x87c36ad79bf5c2674fa5356beb033d2d0c2530dfec029e49b17715dc9b765e01\",\n \"type\": \"sell\",\n \"version\": \"2\",\n \"tokensTransferred\": 3150227564.2627287,\n \"backingCurrencyValue\": 2.047753615909937,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17965330,\n \"timestamp\": 1692647843,\n \"backingCurrencyPrice\": 1673.11,\n \"usd\": 3426.1170523150745,\n \"price\": 0.0000010875776376227965,\n \"pair\": \"0xa43fe16908251ee70ef74718545e4fe6c5ccec9f\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n },\n {\n \"tx\": \"0x0d42f2ae8d3bff63a47d116c11bd5192b31e5728fdf502f33a9c541c8028b17a\",\n \"type\": \"buy\",\n \"version\": \"3\",\n \"tokensTransferred\": 1392148515.2636542,\n \"backingCurrencyValue\": 0.9262361000252599,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17960856,\n \"timestamp\": 1692593759,\n \"backingCurrencyPrice\": 1675.72,\n \"usd\": 1552.1123575343286,\n \"price\": 0.0000011115794853463038,\n \"pair\": \"0x11950d141ecb863f01007add7d1a342041227b58\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n },\n {\n \"tx\": \"0x006040c4edbbe44c2ce99ed8b828972766578ce58b6a238339d21e9c9397ec84\",\n \"type\": \"buy\",\n \"version\": \"3\",\n \"tokensTransferred\": 1760979048.8730276,\n \"backingCurrencyValue\": 1.185715321360087,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17955168,\n \"timestamp\": 1692524963,\n \"backingCurrencyPrice\": 1670.11,\n \"usd\": 1980.275015356695,\n \"price\": 0.000001121179165123775,\n \"pair\": \"0x11950d141ecb863f01007add7d1a342041227b58\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n },\n {\n \"tx\": \"0xa0907c129355bab8b19a884afa3deda8938f17c5c1ee628174c91899840a6c37\",\n \"type\": \"sell\",\n \"version\": \"3\",\n \"tokensTransferred\": 679082674.9997507,\n \"backingCurrencyValue\": 0.45408768910510433,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17928792,\n \"timestamp\": 1692205859,\n \"backingCurrencyPrice\": 1820.86,\n \"usd\": 826.8301095839203,\n \"price\": 0.0000012212198163062868,\n \"pair\": \"0x11950d141ecb863f01007add7d1a342041227b58\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n },\n {\n \"tx\": \"0x9133dea77a95201ae60053fbf06c6fa8d4b79b923de78b639f1bf284797ce6eb\",\n \"type\": \"buy\",\n \"version\": \"3\",\n \"tokensTransferred\": 679082674.9997507,\n \"backingCurrencyValue\": 0.51,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17915926,\n \"timestamp\": 1692050375,\n \"backingCurrencyPrice\": 1844.94,\n \"usd\": 940.9194,\n \"price\": 0.0000013814606788277493,\n \"pair\": \"0x11950d141ecb863f01007add7d1a342041227b58\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n },\n {\n \"tx\": \"0x48e2ac7a9ddc9e43178039cb9455e9f7056c1fbba25ad38d50a61b2299c22280\",\n \"type\": \"sell\",\n \"version\": \"3\",\n \"tokensTransferred\": 343753120.0561592,\n \"backingCurrencyValue\": 0.25633421181010885,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17905287,\n \"timestamp\": 1691921867,\n \"backingCurrencyPrice\": 1850.46,\n \"usd\": 474.33620558613404,\n \"price\": 0.0000013839875587964483,\n \"pair\": \"0x11950d141ecb863f01007add7d1a342041227b58\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n },\n {\n \"tx\": \"0x52f8824c4680c7f69b0e811ebfa05457d6a87f3dd4daee5e0ee1ad70ea0c995b\",\n \"type\": \"buy\",\n \"version\": \"2\",\n \"tokensTransferred\": 343753120.0561592,\n \"backingCurrencyValue\": 0.2478125,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17897049,\n \"timestamp\": 1691822339,\n \"backingCurrencyPrice\": 1847.45,\n \"usd\": 457.821203125,\n \"price\": 0.0000013318314115962219,\n \"pair\": \"0xa43fe16908251ee70ef74718545e4fe6c5ccec9f\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n },\n {\n \"tx\": \"0x7317be1ca7d9c1aff06e5957f97884c1d5e21e2419061d0a529625785ab282a9\",\n \"type\": \"buy\",\n \"version\": \"3\",\n \"tokensTransferred\": 6968986.863133992,\n \"backingCurrencyValue\": 0.005,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17797387,\n \"timestamp\": 1690617851,\n \"backingCurrencyPrice\": 1872.13,\n \"usd\": 9.360650000000001,\n \"price\": 0.0000013391573249716554,\n \"pair\": \"0x11950d141ecb863f01007add7d1a342041227b58\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n },\n {\n \"tx\": \"0x6329304e6c13f81ad5ce159b30d86b3c09ba0c1e1a0b290c1292d9e90a9a4de7\",\n \"type\": \"buy\",\n \"version\": \"3\",\n \"tokensTransferred\": 6929356.485024605,\n \"backingCurrencyValue\": 0.005,\n \"backingCurrencyType\": \"weth\",\n \"blockNumber\": 17796751,\n \"timestamp\": 1690610183,\n \"backingCurrencyPrice\": 1874.35,\n \"usd\": 9.37175,\n \"price\": 0.000001348413308718908,\n \"pair\": \"0x11950d141ecb863f01007add7d1a342041227b58\",\n \"origin\": \"0xba01a8f92d0226beb53adf9fbea4088dd8c89a31\",\n \"token\": \"0x6982508145454ce325ddbe47a25d4ec3d2311933\"\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "statusCode": { "type": "integer", "example": 200, "default": 0 }, "pageSize": { "type": "integer", "example": 9, "default": 0 }, "nextPage": {}, "prevPage": {}, "trades": { "type": "array", "items": { "type": "object", "properties": { "tx": { "type": "string", "example": "0x87c36ad79bf5c2674fa5356beb033d2d0c2530dfec029e49b17715dc9b765e01" }, "type": { "type": "string", "example": "sell" }, "version": { "type": "string", "example": "2" }, "tokensTransferred": { "type": "number", "example": 3150227564.2627287, "default": 0 }, "backingCurrencyValue": { "type": "number", "example": 2.047753615909937, "default": 0 }, "backingCurrencyType": { "type": "string", "example": "weth" }, "blockNumber": { "type": "integer", "example": 17965330, "default": 0 }, "timestamp": { "type": "integer", "example": 1692647843, "default": 0 }, "backingCurrencyPrice": { "type": "number", "example": 1673.11, "default": 0 }, "usd": { "type": "number", "example": 3426.1170523150745, "default": 0 }, "price": { "type": "number", "example": 0.0000010875776376227965, "default": 0 }, "pair": { "type": "string", "example": "0xa43fe16908251ee70ef74718545e4fe6c5ccec9f" }, "origin": { "type": "string", "example": "0xba01a8f92d0226beb53adf9fbea4088dd8c89a31" }, "token": { "type": "string", "example": "0x6982508145454ce325ddbe47a25d4ec3d2311933" } } } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"statusCode\": 400,\n \"error\": \"Bad request\",\n \"code\": 400\n}" } }, "schema": { "type": "object", "properties": { "statusCode": { "type": "integer", "example": 400, "default": 0 }, "error": { "type": "string", "example": "Bad request" }, "code": { "type": "integer", "example": 400, "default": 0 } } } } } }, "429": { "description": "429", "content": { "text/plain": { "examples": { "Result": { "value": "{\n \"statusCode\": 429,\n \"error\": \"Too Many Requests\",\n \"code\": 429\n}" } }, "schema": { "type": "object", "properties": { "statusCode": { "type": "integer", "example": 429, "default": 0 }, "error": { "type": "string", "example": "Too Many Requests" }, "code": { "type": "integer", "example": 429, "default": 0 } } } } } } }, "deprecated": false, "security": [] } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true, "_id": "64402e73f9d01b0f649773db:64e3b031fa9b0100325a18c7" } ```