Skip to main content

Getting Started with Elfa APIs

Welcome to the Elfa API documentation.

Access Modes​

Elfa provides two ways to call APIs:

  1. API key mode (/v2/*, /v2/auto/*)
  2. Keyless x402 mode (/x402/v2/*)

API Key Mode (Most /v2/* endpoints)​

Get your API key from the Elfa Developer Portal.

Use this header:

x-elfa-api-key: your_api_key_here

JavaScript Example​

import axios from "axios";

const API_KEY = "your_api_key_here";

async function getTrendingTokens() {
  const response = await axios.get(
    "https://api.elfa.ai/v2/aggregations/trending-tokens",
    {
      headers: {
        "x-elfa-api-key": API_KEY,
      },
      params: {
        timeWindow: "24h",
      },
    },
  );

  return response.data;
}

Auto API (/v2/auto/*)​

/v2/auto/* also requires x-elfa-api-key.

Mutation endpoints additionally require:

  • x-elfa-signature
  • x-elfa-timestamp

Details and route matrix: /auto/overview

x402-specific Auto differences: /auto/x402

Keyless x402 Mode (/x402/v2/*)​

If you prefer pay-per-request usage without API keys, use x402 payment headers.

Details: x402 Payments

Rate Limits​

REST API rate limits depend on your subscription tier:

  • Free / Chill / PAYG: 60 requests per minute
  • Grow: 120 requests per minute

See Rate Limits for monthly usage details.

Next Steps​

  1. REST API reference: /api/rest/elfa-api
  2. Auto: /auto/overview
  3. Auto x402 instructions: /auto/x402
  4. x402 keyless flow: /x402-payments