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

Other Endpoints

PreviousPnL LeaderboardNextEndpoint Showcase

Last updated 3 days ago

Was this helpful?

  • POSTgrowth-chain-rank
  • POSThot-contracts

growth-chain-rank

post

This endpoint includes the key metrics across different chains.

Parameters | Parameter | Type | Description |

|------------|--------|---------------------------------------------------| | time_frame | String | The time frame in days to consider for the statistics. |

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/growth-chain-rank HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "parameters": {
    "timeFrame": null,
    "chainType": null
  }
}
[
  {
    "blockDate": "text",
    "chain": "text",
    "cntTxs": "text",
    "cntTxsPctChange": "text",
    "cntSuccessfulTxs": "text",
    "cntSuccessfulTxsPctChange": "text",
    "totalGasUsedUsd": "text",
    "totalGasUsedUsdPctChange": "text",
    "totalDexVolumeUsd": "text",
    "totalDexVolumeUsdPctChange": "text",
    "cntActiveAddressesTraces": "text",
    "cntActiveAddressesTracesPctChange": "text",
    "cntActiveAddressesTxs": "text",
    "cntActiveAddressesTxsPctChange": "text"
  }
]

hot-contracts

post

This endpoint provides information about USD flow into/out of contracts. It is used to identify the most active contracts on the chain.

Parameters | Parameter | Type | Description |

|------------------|---------|----------------------------------------------------------------------------------| | date_from | String | Date from which we calculate the flow. Can either be 1D, 7D or 30D. | | date_to | String | It has to be today for now | | is_inflow | Boolean | Wether to calculate inflow or outflow. True for inflow, False for outflow. | | only_smart_money | Boolean | If true, only smart money flow is considered. If false, all money is considered. | | labels | Array(String) | An array of labels to filter the wallets interacting with the contracts. |

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

{
  "parameters": {
    "chain": "ethereum",
    "timeRange": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "isInflow": true,
    "onlySmartMoney": true,
    "labels": [
      "Smart Money"
    ]
  }
}
[
  {
    "address": "text",
    "addressLabel": "text",
    "flow": "text",
    "prevFlow": "text",
    "flowChangePct": "text",
    "wallets": "text",
    "smartWallets": "text",
    "type": "text",
    "entity": "text",
    "totalValue": "text",
    "prevTotalValue": "text",
    "totalValueChangePct": "text"
  }
]