GET /api/tickers
API Reference
GET /api/tickers
Retrieve all DAO tickers with pricing and volume information
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
Price Calculation
Price Calculation
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 Calculation
Volume Calculation
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 Calculation
Liquidity Calculation
Liquidity is calculated as double the quote reserves (for stablecoin pairs).Formula:
liquidity = 2 * quoteReservesAssumes symmetric liquidity for stablecoin-denominated pools.Bid/Ask Spread
Bid/Ask Spread
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)
Filtering
Only DAOs with:- Valid pool reserves (non-zero)
- Accessible on-chain data
- Not in the exclusion list
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
Related Documentation
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
