search
githubx-twitteryoutube

robotAgent

hashtag
Fast Research Agent

post

Ask the Nansen AI agent a research question and receive a streamed answer backed by on-chain data. The fast variant uses a lighter model optimised for low-latency responses.

What it helps to answer:

  1. Which tokens are smart money accumulating right now?

  2. What is the current narrative driving activity in DeFi?

  3. Which wallets are connected to a specific address?

  4. What is the on-chain story behind a recent price move?

SSE event types:

The response is a text/event-stream with the following JSON event types:

type
payload
description

delta

{"type": "delta", "text": "…"}

Incremental text chunk of the agent's answer.

tool_call

{"type": "tool_call", "name": "…"}

Emitted once per unique Nansen tool the agent invokes.

finish

{"type": "finish", "conversation_id": "…", "tool_calls": [...]}

Final event. Contains the conversation_id for follow-up requests and the full list of tools used.

error

{"type": "error", "error": "…", "status_code": …}

Emitted if the upstream agent service is unavailable or times out.

The stream terminates with a data: [DONE] sentinel.

Fast vs Expert: Use /agent/fast for quick factual lookups and simple questions. Use /agent/expert when you need deeper multi-step analysis or synthesis across multiple data sources.

Authorizations
apiKeystringRequired

API key for authentication

Body

Request model for Agent Research endpoints (fast and expert).

textstring · min: 1Required

Research query or question for the Nansen AI agent.

Example: Which tokens are whales accumulating on Ethereum this week?
conversation_idany ofOptional

Optional conversation ID for multi-turn interactions. Returned in the finish event of a previous response. Omit to start a new conversation.

Example: conv_abc123
stringOptional
Responses
chevron-right
200

Server-Sent Events stream. Each event is a data: {json} line. See endpoint description for event schema.

Responseany
post
/api/v1/agent/fast
No content

hashtag
Expert Research Agent

post

Ask the Nansen AI agent a research question and receive a streamed answer backed by on-chain data. The expert variant uses a more capable model for deeper, multi-step analysis.

What it helps to answer:

  1. Which tokens are smart money accumulating right now?

  2. What is the current narrative driving activity in DeFi?

  3. Which wallets are connected to a specific address?

  4. What is the on-chain story behind a recent price move?

SSE event types:

The response is a text/event-stream with the following JSON event types:

type
payload
description

delta

{"type": "delta", "text": "…"}

Incremental text chunk of the agent's answer.

tool_call

{"type": "tool_call", "name": "…"}

Emitted once per unique Nansen tool the agent invokes.

finish

{"type": "finish", "conversation_id": "…", "tool_calls": [...]}

Final event. Contains the conversation_id for follow-up requests and the full list of tools used.

error

{"type": "error", "error": "…", "status_code": …}

Emitted if the upstream agent service is unavailable or times out.

The stream terminates with a data: [DONE] sentinel.

Fast vs Expert: Use /agent/fast for quick factual lookups and simple questions. Use /agent/expert when you need deeper multi-step analysis or synthesis across multiple data sources.

Authorizations
apiKeystringRequired

API key for authentication

Body

Request model for Agent Research endpoints (fast and expert).

textstring · min: 1Required

Research query or question for the Nansen AI agent.

Example: Which tokens are whales accumulating on Ethereum this week?
conversation_idany ofOptional

Optional conversation ID for multi-turn interactions. Returned in the finish event of a previous response. Omit to start a new conversation.

Example: conv_abc123
stringOptional
Responses
chevron-right
200

Server-Sent Events stream. Each event is a data: {json} line. See endpoint description for event schema.

Responseany
post
/api/v1/agent/expert
No content
PreviousPortfolioNextPoints

Last updated

Was this helpful?