Skip to main content

AI chat

POST 
/v2/chat

Send a message to the Elfa AI and receive a complete response. Suited for agents and integrations that do not support server-sent events (SSE).

Session management: omit sessionId to start a new conversation. The response includes a sessionId — pass it in subsequent requests to continue the same conversation.

Analysis types and required fields:

  • chat (default) — general conversation. Requires message.
  • macro — macro market overview. message is optional.
  • summary — quick market summary. message is optional.
  • tokenIntro — token introduction. Requires assetMetadata with symbol, or chain + contractAddress.
  • tokenAnalysis — token trade setup analysis. Same assetMetadata requirements as tokenIntro.
  • accountAnalysis — Twitter/X account analysis. Requires assetMetadata.username.

assetMetadata fields (when applicable):

  • symbol — token ticker symbol (e.g. "BTC", "$ETH")
  • chain — blockchain name (e.g. "ethereum", "solana")
  • contractAddress — token contract address
  • username — Twitter/X username for account analysis

Request​

Responses​

Ok