Get News for Markets

​

AI-Powered News Discovery for Prediction Markets

This endpoint leverages advanced neural search technology to retrieve highly relevant news articles related to specific markets or market topics. By analyzing the semantic meaning of your query, it delivers curated news content that could impact market outcomes, helping traders, researchers, and analysts stay informed about events that might influence prediction market results.

​

How Neural Search Works

Our news discovery system uses sophisticated AI technology to understand the context and meaning behind your market queries:

​

🧠 Neural Search Process

1. Query Understanding: Your market query is processed through advanced language models to understand the semantic meaning and context
2. Exa Neural Search: We use Exa’s state-of-the-art neural search engine to find articles that are conceptually related to your query
3. Content Filtering: Automatically filters out prediction market platforms to avoid circular references and self-referential content
4. Relevance Ranking: Results are ranked by semantic similarity and potential market impact
5. Quality Assurance: Articles are filtered for quality, recency, and relevance

​

🎯 Why This Matters

Traditional keyword-based search might miss crucial news that uses different terminology. For example:

• Searching for “presidential election” will also find articles about “White House race,” “commander in chief,” or “POTUS”
• A query about “AI regulation” will surface news about “artificial intelligence policy,” “machine learning governance,” or “tech oversight”

​

API Reference

​

Path Parameters

​

Query Parameters

​

Response Format

​

Successful Response

{
  "data": [
    {
      "title": "White House Press Secretary addresses recent allegations in heated briefing",
      "url": "https://politico.com/news/2025/01/24/press-secretary-briefing-allegations-123456",
      "publishedDate": "2025-01-24T15:30:00Z",
      "author": "Jane Smith",
      "domain": "politico.com",
      "snippet": "During today's press briefing, the White House Press Secretary directly addressed the allegations, calling them 'completely unfounded' and refusing to dignify what she termed as 'political theater' with further comment..."
    },
    {
      "title": "Political analysts weigh in on administration's communication strategy",
      "url": "https://reuters.com/politics/administration-communication-strategy-789012",
      "publishedDate": "2025-01-24T12:15:00Z",
      "author": "Mike Johnson",
      "domain": "reuters.com", 
      "snippet": "Political experts suggest the administration's recent communication approach may signal a shift in strategy as they navigate mounting political pressure..."
    }
  ],
  "meta": {
    "query": "Will the White House Press Secretary say Hoax",
    "days": 7,
    "limit": 10,
    "totalResults": 2,
    "searchTime": "0.85s",
    "excludeDomains": ["kalshi.com", "metaculus.com", "manifold.markets", "polymarket.com"],
    "searchMethod": "neural", // or "fallback" if neural search failed
    "queryProcessed": "White House Press Secretary communication allegations controversy"
  }
}

​

Response Fields Explained

​

Default Domain Exclusions

To provide the most relevant external news and avoid circular references, we automatically exclude prediction market platforms:

​

Excluded Platforms

• kalshi.com - Kalshi prediction markets
• metaculus.com - Metaculus forecasting platform
• manifold.markets - Manifold Markets
• polymarket.com - Polymarket
• predictit.org - PredictIt
• betfair.com - Betfair prediction markets

​

Customizing Exclusions

You can override or extend these exclusions:

# Exclude additional domains
curl "https://api.data.adj.news/api/news/AI%20regulation?excludeDomains=twitter.com,reddit.com,cnn.com"

# Include only specific domains (overrides defaults)
curl "https://api.data.adj.news/api/news/presidential%20election?includeDomains=reuters.com,bloomberg.com,wsj.com"

​

Comprehensive Examples

​

Basic News Retrieval

# Get recent news about a market topic
curl "https://api.data.adj.news/api/news/presidential%20election%202024"

​

Advanced Filtering

# Get 20 articles from the past 14 days, excluding social media
curl "https://api.data.adj.news/api/news/AI%20regulation?days=14&limit=20&excludeDomains=twitter.com,reddit.com,facebook.com"

​

Focused Source Search

# Get news only from major financial publications
curl "https://api.data.adj.news/api/news/federal%20reserve%20interest%20rates?includeDomains=reuters.com,bloomberg.com,wsj.com,ft.com"

​

Market-Specific News

# News for a specific market question
curl "https://api.data.adj.news/api/news/Will%20the%20US%20inflation%20rate%20exceed%203%25%20in%202025"

​

Use Cases & Applications

​

1. Market Research & Analysis

# Research market fundamentals
curl "https://api.data.adj.news/api/news/US%20inflation%20economic%20indicators?days=30"

Use for: Understanding the underlying factors that might affect market outcomes

​

2. Event Monitoring

# Monitor ongoing events
curl "https://api.data.adj.news/api/news/Supreme%20Court%20decisions?days=3&limit=15"

Use for: Tracking events in real-time that could trigger market resolutions

​

3. Sentiment Analysis Pipeline

# Gather articles for sentiment analysis
curl "https://api.data.adj.news/api/news/cryptocurrency%20regulation?days=7&limit=50"

Use for: Building datasets for sentiment analysis and market prediction models

​

4. Content Aggregation

# Create news feeds for specific topics
curl "https://api.data.adj.news/api/news/climate%20change%20policy?days=7&includeDomains=reuters.com,ap.org,bbc.com"

Use for: Building news dashboards and content aggregation services

​

5. Research & Journalism

# Deep dive research on specific topics
curl "https://api.data.adj.news/api/news/election%20security%20voting%20technology?days=21&limit=30"

Use for: Investigative research and journalistic background gathering

​

Advanced Features

​

Query Optimization Tips

1. Be Specific: “Federal Reserve interest rate decision” vs “Fed rates”
2. Use Market Language: Include terms commonly used in your target market
3. Consider Synonyms: The neural search will find related terms, but specific keywords help
4. Date Sensitivity: Use longer lookback periods for infrequent topics

​

Search Fallback System

If neural search encounters issues, the system automatically falls back to text-based search:

{
  "meta": {
    "searchMethod": "fallback",
    "fallbackReason": "Neural search service temporarily unavailable",
    "queryProcessed": "federal reserve interest rates decision"
  }
}

​

Error Handling

​

Common Error Responses

​

Rate Limited

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

​

Invalid Parameters

{
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "Invalid value for 'days' parameter",
    "details": {
      "parameter": "days",
      "value": 45,
      "allowed_range": "1-30"
    }
  }
}

​

No Results Found

{
  "data": [],
  "meta": {
    "query": "very specific obscure topic",
    "totalResults": 0,
    "suggestion": "Try broadening your search terms or increasing the days parameter"
  }
}

​

Troubleshooting

​

No Results Returned

Problem: Empty results for your query Solutions:

1. Increase the days parameter (try 14-30 days)
2. Broaden your search terms
3. Check if you’re using includeDomains too restrictively
4. Verify the topic has recent news coverage

​

Irrelevant Results

Problem: Results don’t seem related to your market Solutions:

1. Make your query more specific
2. Use exact market question text
3. Add context keywords to clarify meaning
4. Use excludeDomains to filter out noise

​

Rate Limiting Issues

Problem: 429 errors or rate limiting Solutions:

1. Implement exponential backoff (wait 1s, 2s, 4s, 8s…)
2. Cache results to reduce API calls
3. Consider getting an API key for higher limits
4. Batch your requests efficiently

​

Performance & Optimization

​

Response Times

• Typical Response: 0.5-2.0 seconds
• Factors Affecting Speed: Query complexity, number of results, domain filtering
• Optimization: Use smaller limit values for faster responses

​

Caching Recommendations

• Cache Duration: 5-15 minutes for most use cases
• Cache Key: Include all parameters in your cache key
• Invalidation: Consider invalidating cache for breaking news topics

​

Best Practices

1. Query Construction:

   • Use clear, specific language
   • Include key terms from your market
   • Avoid overly complex queries

2. Parameter Tuning:

   • Start with default parameters
   • Adjust days based on topic frequency
   • Use limit based on your application needs

3. Error Handling:

   • Always handle rate limiting gracefully
   • Implement retry logic with exponential backoff
   • Log errors for monitoring and debugging

4. Integration:

   • Cache results appropriately
   • Consider parallel requests for multiple topics
   • Monitor your usage patterns

Need help? Contact our support team at lucas@adj.news with:

• Your specific use case
• Example queries that aren’t working as expected
• Performance or integration questions