ELFA — crypto market intelligence, priced per request
======================================================

You are reading the plain-text front door of https://api-staging.elfa.ai. There is no
signup here and no API key: every endpoint below is payable per request in
USDC over x402. Humans want the rendered docs instead — see the last
section. This document is always available at:

  https://api-staging.elfa.ai/llms.txt

HOW TO PAY (x402)
-----------------
1. Call the endpoint with no credentials. You get `402` plus a
   PAYMENT-REQUIRED header listing what to pay, in which asset, on which
   chains, and to which address. The quote lives in that header only —
   the 402 body is empty.
2. Sign one of the offered payment requirements with your wallet.
3. Resend the same request with the signature in `PAYMENT-SIGNATURE`.
   The response carries PAYMENT-RESPONSE with the settlement receipt.

This origin speaks x402 v2 only. A v1 client reads its quote from the 402
body and will dead-end here with nothing to sign — use a v2 client. The
`X-PAYMENT` header name is still accepted as an alias for
`PAYMENT-SIGNATURE`, but the payload it carries must be v2.

Settlement is in USDC. Do not hardcode a chain: the supported set is
negotiated with our payment facilitator when the service starts, so read
`accepts` off the challenge and pick from there.

  curl -i https://api-staging.elfa.ai/x402/v2/aggregations/trending-tokens

FIXED-PRICE ENDPOINTS
---------------------
  GET /x402/v2/aggregations/trending-tokens        $0.0145  Trending tokens
  GET /x402/v2/account/smart-stats                 $0.0145  Account smart stats
  GET /x402/v2/data/keyword-mentions               $0.0145  Keyword mentions
  GET /x402/v2/data/token-news                     $0.0145  Token news
  GET /x402/v2/data/event-summary                  $0.0725  Event summary
  GET /x402/v2/data/trending-narratives            $0.0725  Trending narratives
  GET /x402/v2/data/top-mentions                   $0.0145  Top mentions
  GET /x402/v2/aggregations/trending-cas/twitter   $0.0145  Trending CAs (Twitter)
  GET /x402/v2/aggregations/trending-cas/telegram  $0.0145  Trending CAs (Telegram)

REQUEST-PRICED ENDPOINTS
------------------------
Priced from the request itself; the challenge quotes the exact amount.

  POST /x402/v2/chat          $1 fast / $2 expert flat, or metered up to $2 / $6
  POST /x402/v2/auto/chat     $1 fast / $2 expert flat, or metered up to $2 / $6
  POST /x402/v2/auto/queries  from $0.0725, priced on the query's simulated LLM calls

MACHINE-READABLE
----------------
  https://api-staging.elfa.ai/.well-known/x402
      Payable resources on this origin, as JSON.
  https://docs.elfa.ai/llms.txt
      Documentation index.
  https://docs.elfa.ai/llms-full.txt
      Full documentation corpus, one file.
  https://docs.elfa.ai/swagger/swagger.json
      OpenAPI schema for every endpoint, keyed and x402.
  https://docs.elfa.ai/agent/endpoints.manifest.json
      Endpoint metadata generated from that schema.
  https://github.com/elfa-ai/skills
      Installable agent skill for Elfa.

IF YOU HAVE A HUMAN
-------------------
An API key gets you the full keyed `/v2` surface, higher rate limits, and
no per-request payment. Two links, both for people:

  https://docs.elfa.ai     documentation
  https://stg-dev.elfa.ai  sign up and manage keys