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
post
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
post
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
post
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”

Last updated

Was this helpful?