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
      • Labels
    • Token God Mode
      • Token Overview
      • Transactions
      • Holders
      • Exchanges
      • PnL Leaderboard
  • Other Endpoints
  • 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

Exchanges

PreviousHoldersNextPnL Leaderboard

Last updated 3 days ago

Was this helpful?

  • POSTtgm/exchanges/balances
  • POSTtgm/exchanges/flows
  • POSTtgm/exchanges/transactions

tgm/exchanges/balances

post

This endpoint shows the balances of the exchanges that hold the given input token.

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

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/exchanges/balances HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 102

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": null,
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    }
  }
}
[
  {
    "exchange": "text",
    "currentBalance": "text",
    "balanceChange": "text",
    "firstReceivedAt": "text"
  }
]

tgm/exchanges/flows

post

This endpoint shows exchanges' token inflow and outflow by date.

Parameters | Parameter | Type | Description | | --------- | ---- | ----------- | | param_token_address | FixedString(42) | Token address input. | | param_date_from | String | Date range start input, format YYYY-MM-DD | | param_date_end | String | Date range end input, format YYYY-MM-DD |

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/exchanges/flows HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": null,
    "dateFrom": null,
    "dateTo": null
  }
}
[
  {
    "blockDate": "text",
    "exchangesInflow": "text",
    "exchangesOutflow": "text",
    "exchangesNetflow": "text"
  }
]

tgm/exchanges/transactions

post

List of transactions to & from exchanges involving the given token.

Parameters | Parameter | Type | Description | |----------------| ---- |---------------------------------------------| | 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 | | is_withdrawal | Boolean | Withdrawal flag. |

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/exchanges/transactions HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 162

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "isWithdrawal": true,
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    }
  }
}
[
  {
    "transactionHash": "text",
    "fromAddress": "text",
    "fromLabel": "text",
    "toAddress": "text",
    "toLabel": "text",
    "value": "text",
    "blockTimestamp": "text"
  }
]