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. Getting Started

API Structure & Base URL

All interactions with the Nansen API occur via HTTPS requests to specific endpoints. The general structure of an API call is:

HTTP Method + Base URL + Endpoint Path
  • HTTP Method: Primarily POST for retrieving data.

  • Base URL: The root URL for all API requests is:

    https://api.nansen.ai/api/beta
  • Endpoint Path: The specific path identifying the resource and desired data, appended directly to the Base URL (e.g., /smart-money/inflows). Endpoint paths for specific resources are detailed within their respective sections of this documentation.

  • Request Body: Parameters are typically passed in JSON format within the request body for POST requests. For example:

    {
      "parameters": {
        "smFilter": ["180D Smart Trader", "Fund", "Smart Trader"],
        "chains": ["ethereum", "solana"],
        "includeStablecoin": true,
        "includeNativeTokens": true,
        "excludeSmFilter": []
      }
    }
    
PreviousPrerequisitesNextAuthentication

Last updated 2 days ago

Was this helpful?

🌐