Skip to main content
ELUUP provides pay-per-request market data APIs for developers and autonomous agents. Access is settled on-chain in USDC on Base, with no ELUUP account, subscription, or API key required. Use this section to integrate the x402 APIs, understand pricing, and discover the available endpoints.

​
Overview

This document is a developer reference for integrating with the ELUUP x402 API endpoints. It covers:
  • Client-side setup for calling x402-protected endpoints
  • Available API endpoints, free and paid
  • x402 payment requirements and pricing
  • Request parameters and validation rules
  • Successful response structures and field definitions
  • Nullable fields
  • HTTP status codes
  • Application-level error structures
  • How to read and debug a 402 Payment Required response
  • Request and response examples
This documentation is intended for developers and autonomous agents consuming the ELUUP APIs programmatically. No ELUUP account, subscription, or API key is required — access is pay-per-request, settled on-chain in USDC on Base.

​
API Endpoints

Important: The maximum batch size for all token-batch APIs is 5 tokens per request, and every token in a batch must be unique (see Duplicate Token Error).

​
x402 Payment Configuration

Paid APIs use the following x402 configuration. The paid endpoints are protected by the x402 payment middleware. The /v1/supported-tokens endpoint is not included in the x402 payment middleware and is therefore free.

​
Pricing

​
Token-Batch APIs

The following APIs are priced per token:
  • /v1/token-signals
  • /v1/token-prices
  • /v1/signal-history
  • /v1/token-win-rate
  • /v1/token-avg-prices
The maximum number of tokens per request is 5, and duplicate identifiers within the same request are rejected before any payment is requested (no charge).

​
Token Signals — $0.05/token

​
Token Prices — $0.03/token

​
Signal History — $0.05/token

​
Token Win Rate — $0.03/token

​
Token Average Prices — $0.02/token

​
Fixed-Price APIs

​
Top Performers — $0.06/request

The price does not depend on the limit value.

​
Aggregate Metrics — $0.06/request

The price does not depend on any request parameters.

​
Complete Pricing Reference

x402 docs: Overview · Quickstart · Payment Flow · API Reference · Errors & Troubleshooting · Examples