Transactions

tgm/dex-trades

post

This endpoint includes DEX trades for a specified token.

Parameters

Parameter	Type	Description
token_address	FixedString(42)	The Token address
date_from	String	Datetime range start input, format YYYY-MM-DDTHH:MM:SS
date_to	String	Datetime range end input, format YYYY-MM-DDTHH:MM:SS
only_smart_money	Bool	Whether only DEX Trades from Smart Money should be returned

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/tgm/dex-trades HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 281

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "onlySmartMoney": null,
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "traderAddressHexSmartSegmentIds": null,
    "traderAddressHexCustomLabels": null,
    "includeLabels": null,
    "excludeLabels": null
  }
}

[
  {
    "blockTimestamp": "text",
    "transactionHash": "text",
    "traderAddressHex": "text",
    "traderName": "text",
    "action": "text",
    "tokenAddressHex": "text",
    "tokenName": "text",
    "tokenLogo": "text",
    "tokenAmount": "text",
    "tradedTokenAddressHex": "text",
    "tradedTokenName": "text",
    "tradedTokenLogo": "text",
    "tradedTokenAmount": "text",
    "estimatedSwapPriceUsd": "text",
    "estimatedValueUsd": "text"
  }
]

tgm/transfers

post

This endpoint includes the top token transfers for tokens by value within the specified dates.

Parameters

Parameter	Type	Description
param_token_address	FixedString(42)	Token address input
date_from	String	Date range start input, format YYYY-MM-DD
date_to	String	Date range end input, format YYYY-MM-DD
param_dex_included	String	should the dex trades be included or not
param_cex_included	String	should the cex trades be included or not

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/tgm/transfers HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 384

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": null,
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "dexIncluded": null,
    "cexIncluded": null,
    "onlySmartMoney": null,
    "fromAddressSmartSegmentIds": null,
    "fromAddressCustomLabels": null,
    "toAddressSmartSegmentIds": null,
    "toAddressCustomLabels": null,
    "fromIncludeLabels": null,
    "fromExcludeLabels": null,
    "toIncludeLabels": null,
    "toExcludeLabels": null
  }
}

[
  {
    "blockTimestamp": "text",
    "transactionHash": "text",
    "fromAddress": "text",
    "toAddress": "text",
    "fromLabel": "text",
    "toLabel": "text",
    "sigHashBytes": "text",
    "txType": "text",
    "value": "text",
    "valueUsd": "text"
  }
]

tgm/jup-dca

post

List of DCA orders created on Jupiter.

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/tgm/jup-dca HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 158

{
  "parameters": {
    "chain": "solana",
    "tokenAddress": "So11111111111111111111111111111111111111112",
    "includeLabels": [
      "Smart Money"
    ],
    "excludeLabels": [
      "Smart Money"
    ]
  }
}

[
  {
    "sinceTimestamp": "text",
    "lastTimestamp": "text",
    "traderAddress": "text",
    "creationHash": "text",
    "traderLabel": "text",
    "dcaVaultAddress": "text",
    "inputMintAddress": "text",
    "outputMintAddress": "text",
    "depositAmount": "text",
    "depositSpent": "text",
    "otherTokenRedeemed": "text",
    "closed": "text",
    "tokenInput": "text",
    "tokenOutput": "text",
    "depositUsdValue": "text"
  }
]