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.

POSThttps://api-v2.idefi.ai/api/narrative/generate

Authorization

user_uidAuth

Body

application/json

wallet_address*string

Ethereum wallet address to analyze.

Example: "0xYourWalletAddressHere"

user_uid*string

Unique identifier for the user.

Example: "abc123-uid"

Response

200400401

AI narrative created successfully.

Body

application/json

narrative_urlstring

URL to the generated AI-powered blockchain narrative.

Example: "https://idefi.ai/narratives/0xYourWalletAddressHere.html"

summarystring

AI-generated summary of the wallet’s blockchain activity.

Example: "This wallet actively engages across Layer1 and Layer2 chains, with 400+ transactions and a strong NFT portfolio valued at $3,200."

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api-v2.idefi.ai/api/narrative/generate', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer UID",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "wallet_address": "0xYourWalletAddressHere",
      "user_uid": "abc123-uid"
    }),
});
const data = await response.json();

Response

200400401

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