​

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

1. Cache Frequently Accessed Data: Reduce API calls and improve performance
2. Use Appropriate Pagination: Don’t request more data than you need
3. Handle Rate Limits Gracefully: Implement exponential backoff
4. Monitor Your Usage: Track your API usage to avoid unexpected limits
5. 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.