GET /api/volume/aggregate

Retrieve aggregate trading volume with daily breakdown for all DAO tokens

GET /api/volume/aggregate

Overview

The volume aggregate endpoint returns comprehensive trading volume data for all DAO tokens since launch, including daily breakdowns for detailed analysis.

This endpoint aggregates volume data across all DAOs, providing a complete picture of trading activity on the Futarchy protocol.

Request

bash
GET /api/volume/aggregate

No Parameters Required

This endpoint requires no query parameters. It automatically returns aggregate volume data for all active DAOs.

Response

totalVolumestringrequired

Total aggregate trading volume across all DAOs since launch (in USD)

dailyBreakdownarrayrequired

Array of daily volume records

daily record properties
datestring

Date in ISO 8601 format (YYYY-MM-DD)

volumestring

Trading volume for that day (in USD)

tradesnumber

Number of trades executed that day

tokensarrayrequired

Per-token volume breakdown

token properties
mintstring

Token mint address

symbolstring

Token symbol

totalVolumestring

Total volume for this token since launch

Example Request

cURL
curl https://market-api.metadao.fi/api/volume/aggregate
JavaScript
const response = await fetch('https://market-api.metadao.fi/api/volume/aggregate');
const volumeData = await response.json();
console.log(volumeData);
Python
import requests

response = requests.get('https://market-api.metadao.fi/api/volume/aggregate')
volume_data = response.json()
print(volume_data)

Example Response

json
{
  "totalVolume": "5234567.89",
  "dailyBreakdown": [
    {
      "date": "2024-01-15",
      "volume": "125000.00",
      "trades": 342
    },
    {
      "date": "2024-01-14",
      "volume": "98500.50",
      "trades": 287
    }
  ],
  "tokens": [
    {
      "mint": "ZKFHiLAfAFMTcDAuCtjNW54VzpERvoe7PBF9mYgmeta",
      "symbol": "ZKFG",
      "totalVolume": "1250000.00"
    },
    {
      "mint": "ANOTHER_TOKEN_MINT",
      "symbol": "ABC",
      "totalVolume": "875000.00"
    }
  ]
}

Data Characteristics

Volume Calculation

Volume is derived from accumulated protocol fees, providing accurate trading activity metrics.

Formula: volume = protocolFees / feeRate

Uses the protocol fee rate of 0.25% for calculations.

Daily Breakdown

Daily volume data is tracked since each DAO's launch date, providing historical trading patterns and trends.

Per-Token Aggregation

Volume is aggregated per token, making it easy to compare trading activity across different DAOs.

Use Cases

Analytics Dashboards

Display historical volume trends and trading patterns

Market Research

Analyze trading activity across the Futarchy ecosystem

Protocol Metrics

Track overall protocol health and growth

Reporting

Generate volume reports for stakeholders

Rate Limiting

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

Tickers API

Get real-time pricing and volume for all DAOs
Supply API

Get token supply breakdown information
API Overview

Learn about the API architecture

Was this page helpful?