Nansen API

Name: Nansen API
Brand: Nansen API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAnalyticsBusiness IntelligenceapiKey54 EndpointsREST

For Agents

Query labelled on-chain wallet data, smart-money flows, address PnL, and token holders across major chains. POST-based with API key auth.

Install Jentic One Beta

Connect the Nansen API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nansen API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Nansen API.

Track smart-money inflows and outflows for a token across DEX, perpetual, and DCA venues

Profile any wallet address with PnL summary, current and historical balances, and counterparties

Retrieve labelled wallet identities (CEXs, MEV bots, fund desks, smart money) for an address

GET STARTED

Start building with Nansen API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Nansen API, keeping it validated and agent-ready. Nansen is an on-chain analytics platform that surfaces wallet behaviour, smart-money flows, and token-level intelligence across major EVM and non-EVM blockchains. Its API exposes 54 endpoints covering smart-money trades and holdings, address profiling and PnL, Token God Mode (TGM) flows and holders, perpetual positions, prediction markets, and a token screener. Agents can classify wallets, track flows in and out of specific tokens, and assemble dashboards or alerts grounded in labelled wallet data.

Use Cases

Patterns agents use Nansen API for, with concrete tasks.

★ On-Chain Smart-Money Tracking

Crypto research desks and trading agents follow Nansen's labelled smart-money cohorts to spot accumulation and distribution before price action follows. The /api/v1/smart-money/netflow and /api/v1/smart-money/dex-trades endpoints return aggregated and per-trade data so a strategy can detect when a labelled cohort is rotating into a token. Combined with the labels endpoint this turns raw on-chain data into actionable signals.

POST /api/v1/smart-money/netflow with token=USDC and a 24h window, then alert if netflow exceeds $5M positive.

Wallet Profiling and Risk Checks

Compliance and trading platforms profile counterparty wallets before approving transfers or fills. The /api/v1/profiler/address/* family of endpoints returns the address's PnL, current balance, related wallets, counterparties, and labels — including Nansen's premium labels — letting an agent quickly answer 'who is this address and how do they trade'. PnL summary alone often determines whether a wallet is treated as a sophisticated counterparty.

POST /api/v1/profiler/address/labels with an address and reject the transfer if any label includes 'sanctioned' or 'mixer'.

Token God Mode Holder Analytics

Token issuers and analysts use Token God Mode to understand the holder base of a specific asset — flows in and out, top buyers and sellers, PnL leaderboard, and DEX trade activity. Calling /api/v1/tgm/flows and /api/v1/tgm/holders together gives a single report combining net token movement, holder concentration, and best-performing wallets, which can drive treasury and tokenomics decisions.

POST /api/v1/tgm/holders for a target token and surface the top 25 holders with their historical balance trend.

AI Agent Crypto Intelligence

An AI trading or research assistant invoked through Jentic asks open questions like 'is smart money buying this token?' Jentic translates the intent into a Nansen operation, calls it with the API key from the vault, and returns structured data the agent can summarise, chart, or feed into trading logic. The agent never sees the raw apiKey header value.

Search Jentic for 'smart money netflow for token', load POST /api/v1/smart-money/netflow, and execute it for a target token over a 7-day window.

Key Endpoints

54 endpoints — jentic publishes the only available openapi specification for nansen api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/api/v1/smart-money/netflow

Smart-money net inflow and outflow for a token

POST

/api/v1/smart-money/dex-trades

Smart-money DEX trade activity for a token

POST

/api/v1/profiler/address/pnl-summary

PnL summary for an address

POST

/api/v1/profiler/address/labels

Labels attached to an address

POST

/api/v1/profiler/address/premium-labels

Premium labels for an address

POST

/api/v1/tgm/flows

Token God Mode flow analytics for a token

POST

/api/v1/tgm/holders

Top holders for a token

GET

/api/v1/account

Read API key account info

POST

/api/v1/smart-money/netflow

Smart-money net inflow and outflow for a token

POST

/api/v1/smart-money/dex-trades

Smart-money DEX trade activity for a token

POST

/api/v1/profiler/address/pnl-summary

PnL summary for an address

POST

/api/v1/profiler/address/labels

Labels attached to an address

POST

/api/v1/profiler/address/premium-labels

Premium labels for an address

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Nansen apiKey header value is encrypted in the Jentic vault. Agents receive scoped execution tokens, so the raw key is never logged, prompted, or visible to the model.

Intent-based discovery

Agents search Jentic for intents like 'smart money netflow' or 'address pnl summary' and Jentic returns the matching Nansen operation with its input schema, so the agent does not need to navigate 54 endpoints by hand.

Time to first call

Direct integration: 2-4 days to handle auth, request body shape across the profiler, smart-money, and TGM families, and rate-limit backoff. Through Jentic: under 1 hour — search, load, execute.

FAQs

Specific to using Nansen API through Jentic.

Why is there no official OpenAPI spec for Nansen API?

Nansen does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Nansen API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Nansen API use?

Nansen uses an API key passed in the apiKey HTTP header on every request. When called through Jentic the key is encrypted in the MAXsystem vault and the agent receives only a scoped execution token; the raw apiKey value never enters the agent's context.

Can I retrieve a wallet's PnL with the Nansen API?

Yes. POST /api/v1/profiler/address/pnl-summary returns an aggregate PnL view for an address, and POST /api/v1/profiler/address/pnl returns the granular trade-level PnL. Combine with /api/v1/profiler/address/historical-balances to chart a wallet's portfolio value over time.

What are the rate limits for the Nansen API?

Rate limits are tier-dependent and are not declared in the OpenAPI spec. Use GET /api/v1/account to read your current account configuration and stay within the per-minute and per-day quotas reported there. Cache analytics responses where possible — flow and holder data is expensive to compute server-side.

How do I track smart-money flows for a token through Jentic?

Run jentic.search('smart money netflow for token'), select POST /api/v1/smart-money/netflow, then jentic.execute with the token symbol or contract and a time window. Jentic returns the structured netflow object so the agent can compare inflow vs outflow and decide whether to alert or rebalance.

Does the Nansen API support perpetual position data?

Yes. POST /api/v1/profiler/perp-positions and POST /api/v1/profiler/perp-trades return open perp positions and historical perp trades for an address, useful for monitoring leveraged exposure of tracked wallets. The /api/v1/smart-money/perp-trades endpoint covers the full smart-money cohort.

Nansen API

Connect the Nansen API to your agent

Capabilities

Start building with Nansen API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs