Skip to main content
GET
GET /api/tickers

Overview

The tickers endpoint returns comprehensive trading information for all DAOs discovered in the Futarchy protocol. This endpoint automatically discovers and aggregates data without requiring manual configuration.
This endpoint is fully compatible with CoinGecko’s DEX API specification.

Request

No Parameters Required

This endpoint requires no query parameters. It automatically returns all active DAOs with valid pools.

Response

string
required
Unique identifier for the trading pair in format {BASE_MINT}_{QUOTE_MINT}Example: "ZKFHiLAfAFMTcDAuCtjNW54VzpERvoe7PBF9mYgmeta_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
string
required
The base token mint address (Solana PublicKey)
string
required
The quote token mint address, typically USDC
string
The symbol of the base token (e.g., “ZKFG”). May be empty if metadata unavailable.
string
The name of the base token. May be empty if metadata unavailable.
string
The symbol of the quote token (e.g., “USDC”)
string
The name of the quote token (e.g., “USD Coin”)
string
required
The DAO address (Solana PublicKey)
string
required
Current price of base token in terms of quote token (quote/base ratio)
string
required
24-hour trading volume in base token, calculated from protocol fees
string
required
24-hour trading volume in quote token, calculated from protocol fees
string
required
Total pool liquidity in USD
string
required
Best bid price (accounting for price impact)
string
required
Best ask price (accounting for price impact)

Example Request

Example Response

Data Characteristics

Prices are calculated from spot pool reserves only (not conditional/futarchy pools).Formula: price = (quoteReserves / baseReserves) * 10^(baseDecimals - quoteDecimals)This ensures accurate pricing regardless of token decimal differences.
Volume is derived from accumulated protocol fees, providing accurate trading activity.Formula: volume = protocolFees / feeRateUses the PROTOCOL_FEE_RATE configured in your environment (default: 0.25%).
Liquidity is calculated as double the quote reserves (for stablecoin pairs).Formula: liquidity = 2 * quoteReservesAssumes symmetric liquidity for stablecoin-denominated pools.
Bid and ask prices account for price impact from trading.These values represent realistic execution prices for small trades.

Caching

The API implements intelligent caching to optimize performance:
  • Ticker data: Cached for 10 seconds to balance freshness with performance
  • Token metadata: Cached for 100 seconds (longer cache for static data like symbols and names)
Subsequent requests within the cache window return cached data instantly, reducing load on the Solana RPC and improving response times.

Filtering

DAOs can be excluded from results by adding their addresses to the EXCLUDED_DAOS environment variable.
Only DAOs with:
  • Valid pool reserves (non-zero)
  • Accessible on-chain data
  • Not in the exclusion list
will appear in the response.

Rate Limiting

This endpoint is subject to the global rate limit of 60 requests per minute per IP address.

Use Cases

Price Aggregators

Integrate with price tracking platforms like CoinGecko

Trading Dashboards

Display real-time market data for all DAOs

Market Analysis

Analyze trading volumes and liquidity across DAOs

Arbitrage Bots

Monitor prices for arbitrage opportunities

API Overview

Learn about the API architecture

Pricing Methodology

Understand how prices are calculated

Configuration

Configure your API instance

Error Handling

Handle API errors properly