Narratives

Generate AI-Powered Blockchain Narrative

post

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

Authorizations

Body

wallet_addressstringRequired

Ethereum wallet address to analyze.

Example: 0xYourWalletAddressHere

user_uidstringRequired

Unique identifier for the user.

Example: abc123-uid

Responses

200

AI narrative created successfully.

application/json

400

Bad request due to invalid or missing wallet address.

application/json

401

Unauthorized request due to missing or invalid user UID.

application/json

post

HTTPcURLJavaScriptPython

POST /api/narrative/generate HTTP/1.1
Host: api-v2.idefi.ai
Authorization: Bearer UID
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "wallet_address": "0xYourWalletAddressHere",
  "user_uid": "abc123-uid"
}

{
  "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."
}