Napdaq

Napdaq IQ API Documentation

Integrate crowd intelligence data into your applications

Getting Started

Authentication and basic usage

1. Get Your API Key

Pro and Oracle subscribers can create API keys from the API Keys settings page.

2. Authentication

Include your API key in the x-api-key header:

curl -H "x-api-key: napdaq_your_api_key_here" \
  https://api.napdaq.com/napdaq-iq/event/{eventId}

3. Rate Limits

  • • Basic: 1,000 requests/day
  • • Pro: 10,000 requests/day
  • • Oracle: 100,000 requests/day

API Endpoints

Available endpoints and their usage

GET/napdaq-iq/event/:eventId

Get Napdaq IQ analysis for a specific event

Response:

{
  "eventId": "abc123",
  "totalPredictions": 1247,
  "weightedDistribution": {
    "YES": 67.3,
    "NO": 32.7
  },
  "confidence": 85.2,
  "crowdConsensus": "YES",
  "diversityScore": 42.8,
  "expertWeight": 145.6,
  "topPredictors": [
    {
      "userId": "user123",
      "weight": 2.45,
      "accuracyRate": 78.5,
      "oracleIQ": 8942
    }
  ]
}
GET/napdaq-iq/trending?limit=10

Get trending events with high activity and confidence

Query Parameters:

  • • limit (optional): Number of events to return (default: 10)
GET/napdaq-iq/category/:category

Get aggregate insights for a specific category

Categories:

  • • SPORTS
  • • FINANCE
  • • CULTURE
  • • POLITICS
  • • REALITY
POST/napdaq-iq/batch

Get Napdaq IQ for multiple events in one request

Request Body:

{
  "eventIds": ["event1", "event2", "event3"]
}

Response Fields Explained

Understanding the Napdaq IQ data

weightedDistribution

Percentage distribution across all outcomes, weighted by predictor expertise. Higher percentages indicate stronger crowd consensus.

confidence (0-100)

Overall confidence score based on consensus strength and sample size. Higher values indicate more reliable predictions.

crowdConsensus

The most likely outcome according to weighted predictions.

diversityScore (0-100)

Measures opinion diversity. Low scores indicate strong consensus, high scores indicate divided predictions.

expertWeight

Ratio of top predictor influence vs average. Higher values mean experts dominate the prediction.

Code Examples

Integration examples in popular languages

JavaScript / Node.js

const axios = require('axios');

const apiKey = 'napdaq_your_api_key_here';
const eventId = 'event123';

axios.get(`https://api.napdaq.com/napdaq-iq/event/${eventId}`, {
  headers: { 'x-api-key': apiKey }
})
.then(response => {
  const iq = response.data;
  console.log(`Crowd consensus: ${iq.crowdConsensus}`);
  console.log(`Confidence: ${iq.confidence}%`);
})
.catch(error => console.error(error));

Python

import requests

api_key = 'napdaq_your_api_key_here'
event_id = 'event123'

response = requests.get(
    f'https://api.napdaq.com/napdaq-iq/event/{event_id}',
    headers={'x-api-key': api_key}
)

iq = response.json()
print(f"Crowd consensus: {iq['crowdConsensus']}")
print(f"Confidence: {iq['confidence']}%")

Error Handling

Common errors and how to handle them

401 Unauthorized

Invalid or missing API key. Check your x-api-key header.

429 Too Many Requests

Rate limit exceeded. Wait until your daily limit resets (midnight UTC).

404 Not Found

Event not found. Verify the event ID exists.