Narratives

Generate AI-Powered Blockchain Narrative

Creates an AI-enhanced summary of a wallet’s financial transactions, NFT activity, and behavioral insights, returning a hosted narrative URL.

post

/api/narrative/generate

Authorizations

Body

wallet_addressstringrequired

Ethereum wallet address to analyze.

Example: 0xYourWalletAddressHere

user_uidstringrequired

Unique identifier for the user.

Example: abc123-uid

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-v2.idefi.ai/api/narrative/generate' \
  --header 'Authorization: Bearer UID' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_address": "0xYourWalletAddressHere",
    "user_uid": "abc123-uid"
  }'

200

400

401

200

{
  "narrative_url": "https://idefi.ai/narratives/0xYourWalletAddressHere.html",
  "summary": "This wallet actively engages across Layer1 and Layer2 chains, with 400+ transactions and a strong NFT portfolio valued at $3,200."
}

AI narrative created successfully.