Market Trends

​

Analyze Market Trends Over Time

This endpoint provides time-series data to analyze how market metrics change over time. It supports various aggregation intervals and metrics, making it ideal for visualizing trends and patterns.

​

Authentication Required

This endpoint requires API key authentication.

​

Query Parameters

• interval (optional): Time interval for aggregation (day, week, month) - default: day
• metric (optional): Metric to measure (count, volume, probability, liquidity) - default: count
• platform (optional): Filter by platform
• market_type (optional): Filter by market type
• category (optional): Filter by category
• start_date (optional): Start date for trend analysis (ISO format)
• end_date (optional): End date for trend analysis (ISO format)

​

Response Format

{
  "data": [
    {
      "time_period": "2025-01-01",
      "value": 125
    },
    {
      "time_period": "2025-01-02",
      "value": 142
    },
    {
      "time_period": "2025-01-03",
      "value": 137
    }
    // ... more time periods
  ]
}

​

Available Metrics

• count: Number of markets created in each time period
• volume: Total trading volume in each time period
• probability: Average probability across markets in each time period
• liquidity: Average liquidity across markets in each time period

​

Time Intervals

• day: Data aggregated by day
• week: Data aggregated by week
• month: Data aggregated by month

​

Use Cases

1. Trend Analysis: Visualize how market metrics change over time
2. Seasonality Detection: Identify patterns in market creation or volume
3. Platform Comparison: Compare trends across different platforms
4. Category Analysis: Analyze how different market categories evolve

​

Example Queries

# Get daily market creation count for the last month
curl "https://api.data.adj.news/api/analytics/trends?interval=day&metric=count&start_date=2025-02-28&end_date=2025-03-28" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Analyze weekly average probability for politics markets
curl "https://api.data.adj.news/api/analytics/trends?interval=week&metric=probability&category=politics" \
  -H "Authorization: Bearer YOUR_API_KEY"

​

Data Visualization

This endpoint is perfect for creating:

• Line charts showing trends over time
• Bar charts comparing different time periods
• Heat maps visualizing market activity patterns
• Dashboard widgets with trend indicators