Welcome to the Adjacent News API

Adjacent News provides a robust and comprehensive API for accessing data from prediction markets across multiple platforms, along with related news, advanced analytics, and trading information. Our API empowers developers to build sophisticated applications that leverage real-time market data, perform advanced semantic search, access insightful analytics, and stay informed with relevant news coverage.

Getting Started

Base URL

The API is available at https://api.data.adj.news. All API requests should be sent to this base URL followed by the specific endpoint path.

API Status

Monitor API uptime and performance at status.adj.news

Authentication

When Authentication is Required

Some API endpoints require authentication for enhanced access:

Historical Data: Accessing data older than 1 day
Large Datasets: Requests returning more than 100 results
Analytics Endpoints: All analytics and insights endpoints
Trading Data: Recent trades and price history endpoints

Authentication Methods

You can authenticate using any of these methods:

HTTP Bearer Token (Recommended):

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.data.adj.news/api/markets

HTTP API Key Header:

curl -H "Authorization: ApiKey YOUR_API_KEY" \
  https://api.data.adj.news/api/markets

Query Parameter:

curl "https://api.data.adj.news/api/markets?api_key=YOUR_API_KEY"

Getting an API Key

To obtain an API key, please contact our support team at lucas@adj.news. Include:

Your intended use case
Expected request volume
Whether you need access to historical data

Rate Limits & Quotas

Rate Limiting

Unauthenticated requests: 300 requests per minute
Authenticated requests: 1,000 requests per minute

Data Limits

Unauthenticated: Maximum 100 results per request
Authenticated: No limit on result size (subject to reasonable use)

Best Practices

Implement exponential backoff for rate limit errors (429 status)
Cache frequently accessed data to reduce API calls
Use pagination for large datasets
Batch requests when possible

Quick Start Examples

Basic Market Discovery

# Get 10 most recent active markets
curl "https://api.data.adj.news/api/markets?limit=10&status=active&sort=created_at:desc"

# Search for presidential election markets
curl "https://api.data.adj.news/api/search/query?q=presidential%20election&limit=5"

Market Analysis

# Get detailed information about a specific market
curl "https://api.data.adj.news/api/markets/kalshi_KXSECPRESSMENTION-25JUN30-HOAX"

# Find markets related to a specific topic
curl "https://api.data.adj.news/api/markets/related/climate%20change"

News & Information

# Get recent news about a market topic
curl "https://api.data.adj.news/api/news/AI%20regulation?days=7&limit=10"

# Get comprehensive market statistics
curl "https://api.data.adj.news/api/markets/stats" \
  -H "Authorization: Bearer YOUR_API_KEY"

Analytics & Insights

# Analyze platform market share
curl "https://api.data.adj.news/api/analytics/market-share?metric=volume" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get trading activity for a specific market
curl "https://api.data.adj.news/api/trade/recent?market_id=polymarket_example" \
  -H "Authorization: Bearer YOUR_API_KEY"

API Categories

📊 Markets API

Access comprehensive prediction market data with advanced filtering and analysis

The Markets API provides access to thousands of prediction markets across multiple platforms with powerful filtering, sorting, and search capabilities.

Key Features:

Multi-platform Coverage: Kalshi, Polymarket, Manifold Markets, Metaculus, and more
Real-time Data: Live probability updates, volume, and liquidity information
Advanced Filtering: Filter by platform, category, status, date ranges, and numerical values
Flexible Sorting: Sort by any field in ascending or descending order
Rich Metadata: Detailed market information including rules, descriptions, and settlement sources

Available Endpoints:

List Markets: Get markets with comprehensive filtering options
Get Market: Retrieve detailed information about a specific market
Related Markets: Find markets conceptually related to a given market
Market Statistics: Get aggregate statistics across all markets

🔍 Search API

Advanced semantic search powered by AI and vector embeddings

Our Search API goes beyond simple keyword matching to understand the meaning and context of your queries, delivering highly relevant results even when exact terms don’t match.

Key Features:

Semantic Understanding: AI-powered search that understands context and meaning
Vector Embeddings: Advanced machine learning models for similarity matching
Natural Language: Search using everyday language and complex queries
Fallback Protection: Automatic fallback to text search when needed
Relevance Scoring: Results ranked by semantic similarity and relevance

Available Endpoints:

Query Search: Search markets using natural language queries
Related Questions: Find questions related to any text input

📈 Analytics API

Deep insights and data analytics for prediction markets

The Analytics API provides sophisticated analysis tools for understanding market trends, platform performance, and trading patterns.

Key Features:

Market Share Analysis: Understand platform distribution and dominance
Trend Analysis: Track how markets evolve over time
Performance Metrics: Compare markets and platforms across multiple dimensions
Historical Insights: Access historical trends and patterns

Available Endpoints:

Market Share: Analyze distribution across platforms by various metrics
Trend Analysis: Coming soon - market trends over time
Performance Comparison: Coming soon - comparative market analysis

📰 News API

AI-curated news articles related to prediction markets

Our News API uses advanced neural search technology to find the most relevant news articles that might impact market outcomes, helping you stay informed about events that could affect your markets of interest.

Key Features:

Neural Search: AI-powered news discovery using Exa neural search
Market Relevance: Articles specifically relevant to market outcomes
Platform Filtering: Automatically excludes prediction market platforms to avoid circular references
Freshness Control: Configurable time windows for news recency
Quality Curation: Filtered and ranked results for maximum relevance

Available Endpoints:

News for Market: Get news articles related to specific markets or topics

💹 Trade API

Access trading data and market activity

The Trade API provides access to trading activity, price history, and market liquidity data across platforms.

Key Features:

Real-time Trades: Access to recent trading activity
Price History: Historical price data with various time intervals
Market Activity: Volume, liquidity, and trading statistics
Multi-platform: Trading data across supported platforms

Available Endpoints:

Market Trades: Get trading activity for specific markets
Recent Trades: Latest trades across platforms
Price History: Historical price data with OHLCV format

Response Format Standards

All API responses follow a consistent structure:

{
  "data": [], // or {} for single objects
  "meta": {
    // Metadata about the response (pagination, query info, etc.)
  }
}

Error Responses

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please try again later.",
    "details": {
      "reset_time": "2025-01-24T15:30:00Z"
    }
  }
}

Common HTTP Status Codes

200: Success
400: Bad Request - Invalid parameters
401: Unauthorized - API key required or invalid
403: Forbidden - Insufficient permissions
404: Not Found - Resource doesn’t exist
429: Rate Limited - Too many requests
500: Internal Server Error - Server issue

SDKs and Tools

MCP (Model Context Protocol)

Integrate with AI assistants and language models:

npx @mintlify/mcp@latest add adjacent

Coming Soon

Python SDK
Node.js SDK
REST client libraries

Community & Support

Getting Help

Email Support: lucas@adj.news
Documentation Issues: Report inaccuracies or suggest improvements
Feature Requests: Let us know what functionality you need

Additional Resources

Trading Interface: trade.adj.news - Visual market exploration
Main Website: adj.news - News and market insights
Status Page: status.adj.news - API uptime monitoring

Best Practices

Cache Frequently Accessed Data: Reduce API calls and improve performance
Use Appropriate Pagination: Don’t request more data than you need
Handle Rate Limits Gracefully: Implement exponential backoff
Monitor Your Usage: Track your API usage to avoid unexpected limits
Keep API Keys Secure: Never expose API keys in client-side code

For technical support, billing questions, or partnership inquiries, please contact lucas@adj.news.

Markets API

Search API

Analytics API

News API

Trade API

​Welcome to the Adjacent News API

​Getting Started

​Base URL

​API Status

​Authentication

​When Authentication is Required

​Authentication Methods

​Getting an API Key

​Rate Limits & Quotas

​Rate Limiting

​Data Limits

​Best Practices

​Quick Start Examples

​Basic Market Discovery

​Market Analysis

​News & Information

​Analytics & Insights

​API Categories

​📊 Markets API

​🔍 Search API

​📈 Analytics API

​📰 News API

​💹 Trade API

​Response Format Standards

​Error Responses

​Common HTTP Status Codes

​SDKs and Tools

​MCP (Model Context Protocol)

​Coming Soon

​Community & Support

​Getting Help

​Additional Resources

​Best Practices

Welcome to the Adjacent News API

Getting Started

Base URL

API Status

Authentication

When Authentication is Required

Authentication Methods

Getting an API Key

Rate Limits & Quotas

Rate Limiting

Data Limits

Best Practices

Quick Start Examples

Basic Market Discovery

Market Analysis

News & Information

Analytics & Insights

API Categories

📊 Markets API

🔍 Search API

📈 Analytics API

📰 News API

💹 Trade API

Response Format Standards

Error Responses

Common HTTP Status Codes

SDKs and Tools

MCP (Model Context Protocol)

Coming Soon

Community & Support

Getting Help

Additional Resources

Best Practices