Browse the docs below. API keys, credits, and live queries are not open to the public yet; launching soon.

AdaBubbles API Documentation

Introduction

The AdaBubbles API provides real-time access to Cardano token data, including prices, market metrics, holder information, and trading activity. All data is sourced directly from on-chain transactions and updated in real-time via DEX webhooks.

Base URL: https://api.adabubbles.net

Authentication

All API requests will require an API key passed in the request header. When the public API launches, connect your Cardano wallet above to generate your key.

Header Format:
X-API-Key: wpup_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • • New users receive 100 free credits upon signup
  • • Each API request costs 1 credit (except portfolio/performance: 2 credits)
  • • Top up anytime by sending ADA to the payment address

Rate Limiting

We use a per-second sliding window rate limiter to ensure fair usage and prevent abuse.

Per Second
5 requests/sec
Smooth, burst-friendly limiting
Per Minute
300 requests/min
Comparable to Blockfrost & CardanoScan

How It Works:

  • • Each API key can make up to 5 requests per second (300 per minute)
  • • Rate limits are enforced per API key using a sliding window
  • • Each IP address is limited to 1 API key — multiple keys per IP are not allowed
  • • If you exceed the limit, wait 1 second and retry

Rate limit headers are included in 429 responses: Retry-After, X-RateLimit-Limit-Second, X-RateLimit-Remaining-Minute

Human-Readable Data

All numeric values are returned in human-readable format - already divided by decimals. No conversion needed.

Token Amounts:
1,000,000 = 1M tokens
ADA Amounts:
123.45 = 123.45 ADA
Prices:
0.00377 ADA/token
Percentages:
14.25 = +14.25%

Data Quality & Filtering

This API is CNT-only: fungible Cardano native tokens. We do not index or serve NFT collection data. List endpoints (like /tokens) filter for quality so only tradeable CNTs appear.

List Endpoint Filters

  • • Must have a ticker symbol
  • • Must have 30+ holders
  • • Must have valid price data (current_price_ada > 0)

Pricing Eligibility (Cron)

  • • ≥10 ADA DEX liquidity; otherwise price/mcap is zeroed
  • • Traded within the last 2 years; otherwise price/mcap is zeroed
  • • Market caps above Cardano's own network mcap (~45B ADA) are repaired or cleared

Filtered Out

  • • NFTs / collectibles (not indexed)
  • • LP / LQ / DeFi receipt tokens
  • • Fake or unrealistic volume
  • • Implausible market caps
  • • Invalid metadata

Specific asset lookups: Lookups by asset ID bypass list filters, so you can access any CNT directly. Tokens missing liquidity or a recent trade still lose price via the cron above, so list results stay clean.

API Endpoints

All endpoints require authentication via the X-API-Key header. Rate limit: 300 requests per minute (5 per second). Cost: 1 credit per request.

Live testing not available yet

Endpoint docs and examples are ready to browse. Wallet connect, API keys, and Run Test open when the public API launches.

Token Endpoints

Get detailed information about specific tokens

Address Endpoints

Analyze address connections, holdings, and transaction patterns (stake or payment)

DeFi Endpoints

Cardano DeFi TVL, protocols, history, and wallet positions. Positions are primarily stake-keyed; pass stake1… or a payment address.

Governance Endpoints

DRep leaderboards, proposal stats (treasury / expiry / turnout), top yes/no/abstain voters, and governance hub KPIs.

Stake Pool Endpoints

Network pool stats, ROS and performance series, retiring pools, and SPO governance votes.

Market Endpoints

Market-wide data and sentiment indicators

Platform Endpoints

Platform-specific token discovery for snek.fun and Chakra AI ecosystems