Capacitr API Docs

Authentication required. Accepts a Privy JWT (Authorization: Bearer <token>) or a Capacitr skill key (X-Capacitr-Skill-Key: <key>). After validating the input, the route reserves one unit from the caller's shared daily UTC quota (default 5) before running the source adapter, scrape, or analysis. If a unit is reserved, it is consumed even if the downstream scrape or analysis fails. The quota resets at UTC midnight; when exhausted the endpoint returns 429 with X-RateLimit-* headers and a JSON body containing error, limit, remaining: 0, and resetAt. GET is not supported and returns 405 Method Not Allowed with Allow: POST.

Accepts a news URL or freetext query. Scrapes the content (URL path via Jina AI), runs LLM extraction to identify tickers, entities, keywords, and categories, then fans out to Polymarket, HyperLiquid, and Deribit to find matching markets. Results are enriched with Quotient mispricing signals and sorted by edge opportunity. Search results are logged to the user_scans Postgres table. A 502 means the upstream scrape or content extraction failed.

POST /api/analyze-link
Content-Type: application/json
Authorization: Bearer eyJ...
# OR: X-Capacitr-Skill-Key: csk_live_...

{
  "url": "https://reuters.com/technology/nvidia-earnings-beat-2025"
}

{
  "mode": "discover",
  "content": {
    "summary": "NVIDIA reported record Q1 earnings...",
    "keywords": ["NVIDIA", "earnings", "semiconductors", "AI chips"],
    "entities": ["NVIDIA", "Jensen Huang"],
    "tickers": ["NVDA"]
  },
  "analysis": {
    "narrative": "NVIDIA's record Q1 earnings beat signals strong AI-chip demand and near-term upside.",
    "keySubjects": ["NVIDIA", "AI chips"],
    "keywords": ["earnings", "semiconductors"],
    "catalysts": [{ "claim": "Raised guidance reinforces AI-chip demand", "direction": "bullish", "strength": "high" }]
  },
  "insights": [
    { "claim": "NVDA guidance raised", "direction": "bullish", "strength": "high", "subjects": ["NVDA"] }
  ],
  "predictions": [
    {
      "question": "Will NVIDIA stock hit $1000 by Q3 2025?",
      "yesPrice": 0.62,
      "noPrice": 0.38,
      "volume": 485000,
      "slug": "will-nvidia-hit-1000"
    }
  ],
  "perps": [
    {
      "asset": "NVDA",
      "markPrice": 872.50,
      "funding": 0.0003,
      "volume24h": 12400000
    }
  ],
  "options": [],
  "searchId": "123e4567-e89b-12d3-a456-426614174000",
  "traceId": "123e4567-e89b-12d3-a456-426614174001",
  "searchUrl": "https://markets.capacitr.xyz/markets?searchId=123e4567-e89b-12d3-a456-426614174000",
  "recommendedTrades": [],
  "bestTrade": null,
  "primaryTrades": [],
  "complementaryTrades": [],
  "nonObviousTrades": [],
  "watchlist": []
}

{
  "error": "Scan link daily limit reached",
  "limit": 5,
  "remaining": 0,
  "resetAt": "2026-07-16T00:00:00.000Z"
}

Proxies requests to the Quotient API for mispricing intelligence on Polymarket markets. Supports three actions: fetching mispriced markets, looking up specific markets by slug, and querying general market intelligence.

GET /api/quotient?action=mispriced&limit=5&min_spread=0.08

GET /api/quotient?action=lookup&slugs=will-bitcoin-hit-100k,eth-merge-by-q3

Streams a response from the Capacitr market research agent using the Vercel AI SDK (Server-Sent Events). The agent can call tools: searchMarkets (Polymarket text search), getMispricedMarkets (Quotient top opportunities), and getMarketIntelligence (Quotient intelligence for a query). Use the useChat hook from ai/react client-side.

POST /api/chat
Content-Type: application/json

{
  "messages": [
    { "role": "user", "content": "What prediction markets exist around the US election?" }
  ]
}

Returns a streaming text/event-stream response in Vercel AI SDK Data Stream format. Compatible with the useChat hook.

Fetches top posts from Reddit subreddits and Hacker News based on the user's interest categories (crypto, politics, ai, tech, finance, sports, pop-culture, music, food, environment). Each post is analyzed by LLM to extract tickers, entities, and generate a prediction card with Polymarket + HyperLiquid + Deribit markets. Results are enriched with Quotient mispricing signals.

GET /api/feed?privyId=did:privy:abc123

{
  "items": [
    {
      "id": "abc123",
      "title": "Bitcoin ETF inflows hit record $2B in single day",
      "source": "reddit",
      "subreddit": "cryptocurrency",
      "url": "https://reddit.com/r/cryptocurrency/...",
      "summary": "Bitcoin ETFs recorded record inflows...",
      "entities": ["Bitcoin", "BlackRock"],
      "tickers": ["BTC"],
      "predictions": [...],
      "perps": [...],
      "options": [],
      "categories": ["crypto", "finance"]
    }
  ]
}

{
  "user": {
    "id": "uuid",
    "privy_id": "did:privy:abc123",
    "privy_provider": "twitter",
    "display_name": "Atown",
    "avatar_url": "https://...",
    "twitter_handle": "capacitr_xyz",
    "farcaster_fid": null,
    "created_at": "2025-01-01T00:00:00Z",
    "interests": ["crypto", "ai", "finance"]
  }
}

{ "interests": ["crypto", "ai", "finance"] }

POST /api/interests
Content-Type: application/json

{ "privyId": "did:privy:abc123", "interests": ["crypto", "ai"] }

{
  "profile": {
    "tier": "aggressive",
    "scores": { "riskTolerance": 8, "timeHorizon": 7, "experience": 9 },
    "completed_at": "2025-03-15T10:22:00Z"
  }
}

Called automatically on login. Upserts the Privy user record into Supabase — creates if new, updates profile fields if existing. Called from the PrivyProviderWrapper on onSuccess.

{ "user": { "id": "uuid", "privy_id": "did:privy:abc123", "display_name": "Atown", ... } }