Quotient API

Endpoints (23 live)

• POST /api/v1/x/profile — Use this to build a citation-grounded profile of one X account. A high-reasoning Grok agent adaptively searches up to 365 days of history across topics and time periods within a hard three-turn ceiling, then returns evidenced interests, beliefs, behavioural tendencies, risk posture, information-processing style, and personalization hints. Every claim cites supporting posts. Matching results are shared from Quotient's cache while less than 30 days old. (1 USDC on Base)
• POST /api/v1/x/search — High-reasoning, adaptive X/Twitter research grounded in citations, powered by Grok. Within a hard three-turn ceiling, it runs multiple targeted searches over a 365-day default/maximum window and returns substantive posts, replies, quote posts, or thread entries plus accounts, a synthesis, gaps, and citations. Use this for sourced research on breaking news, geopolitics, macro, crypto, and event markets using retrieved evidence. (1 USDC on Base)
• GET /api/v1/assets/search — Use this to resolve companies, commodities, cryptoassets, and other underlyings by name, ticker, canonical key, UUID, platform identifier, or linked-market reference. Exact-reference results return every active directly linked non-price market (an Asset's price view is its price outlook) with quote provenance, Q's latest probability and paired thesis, and publication availability. Text results summarize those markets. Probabilities and theses remain tied to their exact questions. (0.01 USDC on Base)
• GET /api/v1/sources — The news and X/Twitter evidence behind Quotient forecasts on Polymarket International, Polymarket US, Kalshi, and HL Outcomes: recent articles and relevant posts for up to ten markets, with reasoning, evidence quotes, source tiers, authors, and canonical routing. Prefer market_keys for cross-venue or nullable-slug rows. Use this to audit a forecast or see what is moving event and asset-linked markets. (5000 on Base)
• GET /api/v1/latest — Use this chronological feed of new forecasts and newly linked articles/X posts across Quotient-covered Polymarket International, Polymarket US, Kalshi, and HL Outcomes listings. Events include canonical venue routing, response-time venue odds with quote provenance, compact forecast context, and thesis, but omit resolution_pathway; use market detail for full rules context. The complete window avoids per-market fan-out. (20000 on Base)
• GET /api/v1/price-outlooks — Use this endpoint to read calibrated asset price outlooks across equities, crypto, and commodities, grouped by settlement source and horizon. Each returns five scenarios plus a labeled whole-curve directional take. The nearest still-open horizon is marked without hiding neutral views. A PriceSignal is a separate current execution call and appears only on its exact Hyperliquid group. (0.01 USDC on Base)
• GET /api/v1/assets — Browse Quotient's canonical underlying-asset directory without forecast or venue-price data. Use this for stable Asset UUIDs and assetKey values, names, tickers, aliases, exact platform identifiers, and active directly linked market counts. The complete filtered catalog returns in one response; use asset search when the user needs linked prediction-market intelligence. (0.005 USDC on Base)
• GET /api/v1/portfolio — Wallet-addressed positions across Polymarket, Polymarket perps, and Hyperliquid, each prediction-market position joined to Quotient's forecast, signal, and a pricing read against the position's own side. Use this for wallet size, prices, PnL, and Q alignment. venues=all covers every venue; omitting venues keeps the legacy Polymarket-only shape. Kalshi and Polymarket US are absent only for lack of a keyless wallet read, with coverage available through the market API. (0.005 USDC on Base)
• GET /api/v1/markets/mispriced — Use this to rank covered markets where Quotient's probability differs from a verified live venue quote. The endpoint batches live reads, then applies the odds band, spread threshold, direction, and sort to one selected quote. Missing, stale, and unsupported live quotes are excluded. Returns quote provenance, routing, Q probability, spread, thesis, and venue-reported volume. (0.02 USDC on Base)
• GET /api/v1/markets — Use this to browse every prediction market Quotient tracks across Polymarket International, Polymarket US, Kalshi, and HL Outcomes, with venue odds and quote provenance, available volume, resolution date, and forecast recency. Polymarket International and Kalshi fail closed when live pricing is unavailable; other venues label graph snapshots stale. Filter by venue or topic; the complete covered catalog returns in one response. (5000 on Base)
• GET /api/v1/markets/lookup — Use this to fetch full Quotient intelligence for up to ten markets across Polymarket International, Polymarket US, Kalshi, and HL Outcomes. Returns forecasts, theses, cited drivers, resolution pathways, venue odds, and quote provenance. Polymarket International and Kalshi fail closed when live pricing is unavailable. Prefer market_keys; legacy slugs and condition IDs default to Polymarket unless venue is supplied. (5000 on Base)
• GET /api/v1/markets/search — Use this to search market titles plus the latest Q summary for a shortlist of recent, open contracts. Returns 10 results by default, at most 20. Use direct topic keywords. Useful alternate angles may use focused searches within a 10-second discovery budget. On a timeout, return candidates already found instead of retrying. Use explicit as_of only for historical questions. Search does not expand graph relationships or run embedding search. (10000 on Base)
• GET /api/v1/signals/featured — Use this when the user asks which prediction-market signal is currently designated as featured by Quotient. Returns its published side and lifecycle, forecast_status, entry and current fields, forecast context, capacity, and canonical market routing; it may be empty. The featured designation is a database field. (0.005 USDC on Base)
• GET /api/v1/signals — Use this to scan Quotient's published prediction-market signals on Polymarket International, Polymarket US, and Kalshi: side, entry YES price, latest Q probability and thesis, the forecast_status gauge with its standing adverse move, upside to Q, and capacity — one signal per market. A signal is active, in_play (game under way; off the default feed) or retired; a missing live quote drops a row, and a caution/warning forecast_status marks an adverse move; the row remains listed. (0.01 USDC on Base)
• GET /api/v1/markets/1/intelligence — Q's forecast with key drivers, correlated article evidence, and venue-quote provenance. Polymarket International and Kalshi use verified live pricing or null; other venues label graph snapshots stale. Per-article direction is null when the correlation does not assess it. (0.01 USDC on Base)
• GET /api/v1/markets/1/signals — Complete list of live Article-RELEVANT_TO-Market evidence (title, correlation reasoning, URL, source, confidence, evidence quote, and timestamps), newest first. Direction is null when the correlation layer does not assess it. These are distinct from published trade signals at /api/v1/signals. If none exist, the route returns 404 and the gateway does not bill or settle the request. (0.01 USDC on Base)
• GET /api/v1/markets/1/forecast — Paid forecast-only read for a known market. Omit as_of for the latest committed forecast, or supply an inclusive historical cutoff. Each forecast carries stored market_odds_at_forecast. Response-time market_odds exactly matches venue_quote.selected_probability: Polymarket International and Kalshi use a verified live quote or null; other venues label graph snapshots stale. The path accepts a slug, nativeMarketId, or marketKey within the selected venue. (0.01 USDC on Base)
• GET /api/v1/signals/perps — Use this for Quotient's calibrated price outlooks (asset-price/1), grouped by price source in series[].basis_groups[]. An asset with outlooks always serves at least one group — assets not yet stamped with a source basis fall back to the legacy head pointer (source: legacy-head-fallback). Different sources do not pool, and a cross-source gap is context, not arbitrage. (10000 on Base)
• GET /api/v1/assets/stance — Use this for Quotient's EXPERIMENTAL per-settle-date stance on one covered asset (asset-stance/1). Market rows (question, Q probability, live venue odds) list when a verified live quote and a Q probability exist; a missing venue quote is the only thing that hides a row. Derived reads and price levels additionally need a grounded settlement reference. Markets without a settlement mapping list in the top-level markets[]. (0.01 USDC on Base)
• GET /api/v1/wallets/link — Payment-as-proof wallet attestation. First obtain a single-use link token from POST /api/auth/wallets/x402-token (authenticated with x-quotient-api-key or a Privy bearer), then call this route with an x402 payment from the wallet being linked — a Bankr wallet via `bankr x402 call`, or any x402-capable signer. The gateway verifies the payment signature and the settled payer wallet is attested to the token's account. Wallets whose keys cannot be exported (custodial or provider-managed) can therefore be linked without any message-signing support. A wallet already attested to a different account returns a non-billable 409; the signature-challenge alternative lives at POST /api/auth/wallets/challenge + /attest. (0.01 USDC on Base)

+3 more endpoints.