Nansen API
  • ✨Introduction
  • 📌Endpoints Overview
  • 🔴Rate Limits and Quotas
  • Getting Started
    • ☑️Prerequisites
    • 🌐API Structure & Base URL
    • 🔓Authentication
    • 🟢Understanding Responses and Handling Errors
    • ⛓️Chain Coverage
  • API
    • Smart Money
    • Profiler
      • Balances
      • Transactions
      • Counterparties
      • Trade Performance
    • Token God Mode
      • Token Overview
      • Holders
      • Flows
      • Transactions
      • PnL Leaderboard
  • Guides
    • 💻Endpoint Showcase
    • 🙋Frequently Asked Questions
  • 🔗Useful Links
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. API
  2. Token God Mode

Transactions

PreviousFlowsNextPnL Leaderboard

Last updated 21 days ago

Was this helpful?

  • POSTtgm/dex-trades
  • POSTtgm/transfers
  • POSTtgm/jup-dca

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