API Overview

Overview of the Futarchy CoinGecko-compatible DEX API

What is This API?

The Futarchy CoinGecko DEX API is a CoinGecko-compatible API that automatically discovers and aggregates all DAOs from the Futarchy protocol, providing real-time pricing and trading information.

This API is fully compatible with CoinGecko's DEX API specification, making it easy to integrate with price aggregators and trading platforms.

Base URL

Code

https://market-api.metadao.fi

All API requests should be made to this base URL.

Available Endpoints

GET /

API information and available endpoints

GET /api/tickers

All DAO tickers with pricing and volume

GET /api/supply/:mint

Token supply breakdown with allocation details

GET /api/volume/aggregate

Aggregate volume with daily breakdown

GET /health

Health check endpoint

Supply Endpoints

Endpoint	Description
GET`/api/supply/:mintAddress`	Returns complete supply breakdown with allocation details
GET`/api/supply/:mintAddress/total`	Returns total supply only
GET`/api/supply/:mintAddress/circulating`	Returns circulating supply (excludes team performance package)

Volume Endpoints

Endpoint	Description
GET`/api/volume/aggregate`	Returns aggregate volume with daily breakdown for all DAO tokens since launch

Root Endpoint

Endpoint: GET/

Returns API information and available endpoints.

Response:

json

{
  "name": "Futarchy AMM - CoinGecko API",
  "version": "1.0.0",
  "documentation": "https://docs.coingecko.com/reference/exchanges-list",
  "endpoints": {
    "tickers": "/api/tickers - Returns all DAO tickers with pricing and volume",
    "supply": "/api/supply/:mintAddress - Returns complete supply breakdown with allocation details",
    "supply_total": "/api/supply/:mintAddress/total - Returns total supply only",
    "supply_circulating": "/api/supply/:mintAddress/circulating - Returns circulating supply (excludes team performance package)",
    "volume_aggregate": "/api/volume/aggregate - Returns aggregate volume with daily breakdown for all DAO tokens since launch",
    "health": "/health"
  },
  "dex": {
    "fork_type": "Uniswap V1",
    "factory_address": "FUTARELBfJfQ8RDGhg1wdhddq1odMAJUePHFuBYfUxKq",
    "router_address": "FUTARELBfJfQ8RDGhg1wdhddq1odMAJUePHFuBYfUxKq"
  },
  "supplyBreakdown": {
    "description": "For launchpad tokens, supply is broken down into:",
    "circulatingSupply": "Total supply minus team performance package (liquidity IS circulating)",
    "teamPerformancePackage": "Locked tokens allocated to the team (price-based unlock) - NOT circulating",
    "futarchyAmmLiquidity": "Tokens in the internal FutarchyAMM for spot trading - IS circulating",
    "meteoraLpLiquidity": "Tokens in the external Meteora DAMM pool (POL) - IS circulating"
  },
  "note": "This API automatically discovers and aggregates all DAOs from the Futarchy protocol."
}

Example Request:

bash

curl https://market-api.metadao.fi/

Health Endpoint

Endpoint: GET/health

Health check endpoint for monitoring API status.

Response:

json

{
  "status": "healthy",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "uptime": 3600.5
}

Response Fields:

statusstringrequired

Health status of the API. Always "healthy" when the endpoint responds successfully.

timestampstringrequired

Current server timestamp in ISO 8601 format.

uptimenumberrequired

Server uptime in seconds.

Example Request:

bash

curl https://market-api.metadao.fi/health

Use this endpoint for automated health monitoring. Set up checks every 1-5 minutes to detect issues early.

Key Features

Automatic DAO Discovery

The API automatically discovers all DAOs from the Futarchy protocol without manual configuration. No need to maintain a list of DAOs - they're discovered dynamically from the blockchain.

Real-Time Pricing

Prices are calculated from spot pool reserves in real-time, accounting for token decimal differences to ensure accuracy.

Volume Tracking

Trading volumes are calculated from accumulated protocol fees, providing accurate volume metrics that reflect actual trading activity.

Liquidity Metrics

Comprehensive liquidity information for all pools, calculated in USD for easy comparison.

High Performance

Built with Bun for exceptional performance, featuring intelligent caching (10s for tickers, 100s for metadata) and rate limiting.

CoinGecko Compatible

Fully compatible with CoinGecko's DEX API specification, making integration seamless with existing tools and platforms.

Rate Limiting

The API implements rate limiting to ensure fair usage:

60 requests per minute per IP address
Returns 429 Too Many Requests when limit is exceeded
Rate limits reset at the start of each minute window

Caching

The API uses intelligent caching to balance freshness with performance:

Tickers: 10 seconds TTL
Token Metadata: 100 seconds TTL (longer cache for static data)

Data Sources

All data comes from on-chain sources:

Solana Blockchain - Pool reserves, DAO accounts, protocol fees
Metaplex Token Metadata - Token symbols, names, and metadata
Spot Pools Only - Prices calculated from spot pools, not conditional markets

Prices are only calculated from spot pools, not conditional/futarchy pools, to ensure spot market accuracy.

Response Format

All endpoints return JSON responses. Error responses follow a consistent format:

json

{
  "error": "Error message describing what went wrong"
}

Next Steps

Tickers Endpoint

Learn about the tickers API endpoint

Supply Endpoint

Get token supply information

Pricing Methodology

Understand how prices are calculated

Quickstart Guide

Get started with the API

Configuration

Configure your API instance

Error Handling

Learn how to handle API errors

Was this page helpful?