Skip to main content
GET
/
api
/
volume
/
aggregate
GET /api/volume/aggregate
curl --request GET \
  --url https://api.example.com/api/volume/aggregate
{
  "totalVolume": "<string>",
  "dailyBreakdown": [
    {
      "date": "<string>",
      "volume": "<string>",
      "trades": 123
    }
  ],
  "tokens": [
    {
      "mint": "<string>",
      "symbol": "<string>",
      "totalVolume": "<string>"
    }
  ]
}

​
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

GET /api/volume/aggregate

​
No Parameters Required

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

​
Response

​
totalVolume
string
required
Total aggregate trading volume across all DAOs since launch (in USD)
​
dailyBreakdown
array
required
Array of daily volume records
​
tokens
array
required
Per-token volume breakdown

​
Example Request

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

​
Example Response

{
  "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 is derived from accumulated protocol fees, providing accurate trading activity metrics.Formula: volume = protocolFees / feeRateUses the protocol fee rate of 0.25% for calculations.
Daily volume data is tracked since each DAO’s launch date, providing historical trading patterns and trends.
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