Transactions

tgm/dex-trades

post

This model returns simple DEX trades for a specified token.

Questions

1. Which addresses have sold the specified token recently? 2. Have Smart Money addresses bought the specified token? 3. Has there been a DEX trade worth more than 1 million USD?

Authorizations

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
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 209

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "onlySmartMoney": true,
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    }
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

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

tgm/transfers

post

This model returns the top transactions for ERC-20 tokens by value within the specified dates.

Questions

1. What are the top transactions by value that happened this year for the BLUR token? 2. What was the largest LDO transaction in the past week? 3. Were there transfers of more than 100 million USDC recently?

Authorizations

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
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 247

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": "0x5a98fcbea516cf06857215779fd812ca3bef1b32",
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "dexIncluded": true,
    "cexIncluded": true,
    "onlySmartMoney": true
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "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 Jupiter DCA orders with stats per vault.

Authorizations

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
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 203

{
  "parameters": {
    "chain": "solana",
    "tokenAddress": "So11111111111111111111111111111111111111112",
    "includeLabels": [
      "Smart Money"
    ],
    "excludeLabels": [
      "Smart Money"
    ]
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "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"
  }
]

To optimize queries on the /tgm/jup-dca endpoint and avoid timeouts, use targeted filters rather than broad searches. Apply these strategies:

1. Set ‎⁠sinceTimestamp⁠ and ‎⁠lastTimestamp⁠ to limit results to a specific period.

2. Filter by ‎⁠traderAddress⁠ to focus on individual users.

3. Use thresholds like ‎⁠depositUsdValue⁠to target significant orders.

4. Filter by ‎⁠status⁠ to separate active from closed orders.

Combining these filters reduces data volume, speeds up queries, and improves reliability.

sinceTimestamp	Start date/time for results	“2025-06-01T00:00:00Z”
lastTimestamp	End date/time for results	“2025-06-27T00:00:00Z”
traderAddress	Filter by specific trader address	“YourTraderAddressHere”
depositUsdValue	Minimum USD value of deposit	1000
status	Order status (“Active” or “Closed”)	“Active”