​

Welcome to the Adjacent News API

​

Getting Started

​

Base URL

​

API Status

​

Authentication

​

When Authentication is Required

• 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

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

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

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

​

Getting an API Key

• 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)

​

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"

​

News & Information

# Get recent news about a market topic
curl "https://api.data.adj.news/api/news?q=ukraine?limit=10"

​

API Categories

​

Markets API

• Multi-platform Coverage: Kalshi, Polymarket, Metaculus, and more coming
• 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

• 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

• 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

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

​

News API

• Neural Search: AI-powered news discovery
• 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

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

​

Trade API

• 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

• 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

{
  "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)

npx @mintlify/mcp@latest add adjacent

​

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