{"openapi":"3.1.0","info":{"title":"OpusIntelligence","version":"0.1.0","summary":"Market measurement datasets for machine buyers, priced per call.","description":"OpusIntelligence publishes observed market measurements as machine-readable feeds.\n\n- `GET /v1/regime` - **free**, no payment or account. Current observed market-state label and coarse condition states.\n- `GET /v1/ecosystem` - **$0.05**. Population statistics for the x402 market itself: how paid demand concentrates across resources and providers, the distribution of repeat usage, price and metadata quality, category mix with demand per listing, and day-over-day change computed from our own daily snapshots.\n- `GET /v1/shortlist?q=` - **$0.01**. Three ranked x402 services for a stated need, with the raw signals behind the ranking. OpusIntelligence excludes its own services.\n- `GET /v1/triad` - **$0.02**. Execution measurements for Kalshi event contracts, aggregated and 24-hour lagged.\n- `GET /v1/treasury-bench` - **$0.02**. A published 45/30/25 BTC/ETH/SOL index specification measured against US Treasury rates, with drawdown, time underwater and rolling-window distribution.\n- `GET /v1/lending-bench` - **$0.02**. Morpho Blue population statistics read from contract state: LLTV practice by collateral class, fee norms, utilisation, and how concentrated the venue's reliance on individual oracle and interest-rate-model contracts is. Funded markets only.\n\nAll feeds are impersonal: the same output is served to every caller, with no consideration of any recipient's circumstances. Observed data only, not trading advice. No provider is rated or endorsed. Full notice travels in every response.","contact":{"name":"OpusAI, LLC","email":"support@opusaiai.com"}},"servers":[{"url":"https://intel.opusai.work"}],"tags":[{"name":"market-data","description":"Observed market measurements."},{"name":"prediction-markets","description":"Event-contract venue data."},{"name":"free","description":"No payment required."}],"paths":{"/v1/ecosystem":{"get":{"operationId":"getEcosystemReport","summary":"Population statistics for the x402 machine-payment market","description":"Population statistics for the x402 machine-payment market. Bands paid volume by how many distinct wallets paid for each endpoint, separating open demand from volume running between a single buyer and seller. Returns demand concentration, repeat-usage distribution, pricing, metadata quality, category mix with demand per listing, and day-over-day change from our own daily snapshots. No provider is named, rated or endorsed. A full, real response is free at https://intel.opusai.work/v1/ecosystem/sample.","tags":["market-data"],"responses":{"200":{"description":"Descriptive statistics over the full discoverable catalog.","content":{"application/json":{"schema":{"type":"object","properties":{"coverage":{"type":"object","description":"Population size, provider count, how many listings took any paid call in the window, and how many days of local observation the change fields rest on."},"concentration":{"type":"object","description":"Share of total paid calls held by the top 1% and top 10% of resources and providers, and the count needed to reach half of all volume. Reported as a distribution, never as a leaderboard."},"market_structure":{"type":"object","description":"Paid volume banded by how many distinct wallets paid for each endpoint, with the share running through endpoints of two payers or fewer against the share reaching ten or more. Volume on a one-payer endpoint is a private arrangement, not reachable demand; headline totals for this market do not separate the two."},"repeat_usage":{"type":"object","description":"Calls per unique payer: p10, median, p90, and the share below 1.5. A ratio near 1 is a single-use pattern and cannot be distinguished from inorganic volume; a ratio in the tens is the one demand signal here that is expensive to fake."},"pricing":{"type":"object","description":"Advertised price per call: percentiles and tail shares."},"metadata_quality":{"type":"object","description":"How many listings publish an output schema or example, and how many carry a description too short to act on. Where this is low, trying a new endpoint costs a paid call with an unknown payload."},"category_mix":{"type":"object","description":"Resources, providers, call share, median price and median repeat ratio per inferred category, with a note flagging categories carrying many listings and disproportionately little demand."},"provider_breadth":{"type":"object"},"networks":{"type":"array","items":{"type":"object"}},"change":{"type":"object","description":"Difference between the earliest and latest locally stored daily snapshots: listings added and delisted, a normalized daily delist rate, and how many survivors grew or shrank. Reports available=false with an explanation until a second day exists; the upstream API publishes a rolling window only, so this cannot be backfilled."},"method":{"type":"object"},"disclaimer":{"type":"string"}},"required":["coverage","concentration","market_structure","repeat_usage","method"]}}}},"402":{"description":"Payment required: $0.05 USDC on eip155:8453 to 0xBc3eb6dc759c0DBBDf0D8351C7Cc8Db3c9191642."},"429":{"description":"Rate limited."},"503":{"description":"Catalog store unavailable; fails closed."}}}},"/v1/treasury-bench":{"get":{"operationId":"getTreasuryBenchmark","summary":"Machine-economy allocation specification measured against Treasury rates","description":"Index specification for a machine-economy treasury allocation - 45/30/25 BTC/ETH/SOL, monthly rebalanced - measured against US Treasury rates over a three-year window. Returns index performance, max drawdown and time underwater, per-sleeve contribution, pairwise sleeve correlation, the distribution across 700+ rolling twelve-month windows, and rolling correlation against the 10-year yield. A published specification, not a position: no holdings, balances or trade timing are disclosed. A full, real response is free at https://intel.opusai.work/v1/treasury-bench/sample.","tags":["market-data"],"responses":{"200":{"description":"Index statistics for a published specification.","content":{"application/json":{"schema":{"type":"object","properties":{"specification":{"type":"object","description":"The published weighting and its character. States plainly that the allocation is concentrated directional exposure with no internal diversification - conviction weighting across three correlated networks, not risk spreading."},"window":{"type":"object"},"index":{"type":"object","description":"Total return, annualized volatility, max drawdown and longest run below a prior peak. Time underwater matters as much as depth: it is what determines whether an allocation is holdable."},"sleeve_contribution":{"type":"object","description":"Weighted contribution per asset; sums to the index return."},"sleeve_correlation":{"type":"object","description":"Pairwise daily-return correlation, published as evidence for the character statement."},"rolling_12m_windows":{"type":"object","description":"Distribution across overlapping twelve-month holding periods: worst, median, best, and the share that were negative. One window is an episode; the spread is the characteristic."},"risk_free_comparison":{"type":"object"},"rates":{"type":"object"},"rolling_correlation_vs_10y":{"type":"object"},"method":{"type":"object"},"disclaimer":{"type":"string"}},"required":["specification","window","index","method"]}}}},"402":{"description":"Payment required: $0.02 USDC on eip155:8453 to 0xBc3eb6dc759c0DBBDf0D8351C7Cc8Db3c9191642."},"429":{"description":"Rate limited."},"503":{"description":"Price or rate series unavailable; fails closed."}}}},"/v1/lending-bench":{"get":{"operationId":"getLendingBenchmark","summary":"Aggregate configuration statistics for a lending venue, read from chain","description":"Aggregate configuration statistics for the Morpho Blue lending venue, read from contract state: LLTV practice by collateral class, fee distribution across vaults and markets, utilization percentiles, and how concentrated the population's reliance on individual oracle and interest-rate-model contracts is. Funded markets only - an empty market has no lending practice to describe, and most markets on a permissionless venue are empty. Population statistics only; no curator, vault or market is identified. A full, real response is free at https://intel.opusai.work/v1/lending-bench/sample.","tags":["market-data"],"responses":{"200":{"description":"Population statistics. No operator is identified.","content":{"application/json":{"schema":{"type":"object","properties":{"venue":{"type":"string","example":"morpho_blue"},"chains":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Markets, vaults and supply covered, and how many days observed. Distinguishes markets reachable from the watched vaults from those actually funded: every statistic describes funded markets only, because an empty market has no lending practice to describe and most markets on a permissionless venue are empty."},"lltv_practice_by_collateral_class":{"type":"object","description":"Liquidation LTV percentiles grouped by collateral class (stablecoin, tokenized_commodity, major_crypto, liquid_staking, pendle_pt). Shows how LLTV is set against collateral of differing volatility."},"shared_dependencies":{"type":"object","description":"How many distinct oracle and interest-rate-model contracts the population relies on, and how concentrated that reliance is. Read from each market's own parameters. No contract is named and none is judged. The two concentrate very differently on this venue, which is the point of reporting them separately."},"fee_norms":{"type":"object","description":"Fee percentiles and median timelock across fee-charging vaults, and separately the per-market fee Morpho Blue itself carries."},"utilization":{"type":"object"},"blocks":{"type":"object","description":"Block height per chain at which the parameters were read. This is the citation: the same query at the same block returns the same answer to anyone."},"not_included":{"type":"object","description":"Sections this feed used to carry and no longer does, each with the reason. Present so a gap is answered in the payload rather than discovered."},"method":{"type":"object"},"disclaimer":{"type":"string"}},"required":["venue","coverage","lltv_practice_by_collateral_class","method"]}}}},"402":{"description":"Payment required: $0.02 USDC on eip155:8453 to 0xBc3eb6dc759c0DBBDf0D8351C7Cc8Db3c9191642."},"429":{"description":"Rate limited."},"503":{"description":"Observations not yet collected; fails closed."}}}},"/v1/shortlist":{"get":{"operationId":"getShortlist","summary":"Ranked shortlist of x402 services for a stated need","description":"Ranked shortlist of x402 services for a stated need. Scores every matching resource in the CDP Bazaar catalogue on repeat usage (calls per distinct payer), reach, recency, published-schema quality and price relative to services answering the same query. Returns three candidates with the raw figures, plain-language reasons, and category context. OpusIntelligence excludes its own services from all rankings. A full, real response is free at https://intel.opusai.work/v1/shortlist/sample.","tags":["market-data"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":200},"example":"real-time twitter data","description":"What the caller needs, in plain words."}],"responses":{"200":{"description":"Ranked candidates with signals and reasons.","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"catalog":{"type":"object","description":"Size and freshness of the indexed catalogue."},"set_context":{"type":"object","description":"Judgement about the CATEGORY, not a single entry - whether anything matching this query shows real repeat usage."},"ecosystem_churn":{"type":"object","description":"Resources added and lost across our own observation window."},"shortlist":{"type":"array","description":"Up to three candidates, best first.","items":{"type":"object","properties":{"resource":{"type":"string"},"description":{"type":"string"},"price_usdc":{"type":"number"},"network":{"type":"string"},"score":{"type":"number"},"verdict":{"type":"string","enum":["strong","solid","adequate","weak"]},"verdict_note":{"type":"string"},"signals":{"type":"object","description":"Raw figures behind the score. calls_per_payer near 1.0 means nearly every call came from a different wallet."},"trend":{"type":"object","description":"Trajectory from our own daily snapshots. Not available from the upstream catalogue at any price."},"provider":{"type":"object"},"why":{"type":"array","items":{"type":"string"}},"watch":{"type":"array","items":{"type":"string"}}}}},"excluded":{"type":"array","description":"Resources removed from ranking, with the reason."},"method":{"type":"object"},"disclaimer":{"type":"string"}},"required":["query","shortlist","set_context","method"]}}}},"400":{"description":"Missing or over-long q parameter."},"402":{"description":"Payment required: $0.01 USDC on eip155:8453 to 0xBc3eb6dc759c0DBBDf0D8351C7Cc8Db3c9191642."},"429":{"description":"Rate limited."},"503":{"description":"Catalogue unavailable; fails closed."}}}},"/v1/triad":{"get":{"operationId":"getTriadConditions","summary":"Kalshi execution measurements, aggregated and lagged","description":"Historical measurement dataset for Kalshi event contracts. Records the mean difference between fill price and prevailing quote at time of fill, in cents per contract, grouped by time to resolution, across 147k+ observations. Aggregate and 24-hour lagged; never per-contract, identical for every caller. Observed historical data only. Not trading advice - full notice in response. A full, real response is free at https://intel.opusai.work/v1/triad/sample.","tags":["market-data","prediction-markets"],"responses":{"200":{"description":"Measurement dataset.","content":{"application/json":{"schema":{"type":"object","properties":{"venue":{"type":"string","description":"Exchange observed.","example":"kalshi"},"measure":{"type":"string","description":"Plain-language statement of what the figures measure."},"units":{"type":"string","example":"cents per contract"},"description":{"type":"string"},"edge_by_lifecycle":{"type":"object","description":"Buckets keyed by time remaining to contract resolution. Bucket keys are stable but not exhaustive; treat as a map.","additionalProperties":{"type":"object","properties":{"n":{"type":"integer","description":"Observations in bucket."},"edge_mean_cents":{"type":"number","description":"Mean fill-vs-quote difference, cents per contract."},"positive_pct":{"type":"number","description":"Percent of observations where the difference was positive."}},"required":["n","edge_mean_cents","positive_pct"]}},"overall":{"type":"object","description":"Same three fields across all buckets combined.","properties":{"n":{"type":"integer"},"edge_mean_cents":{"type":"number"},"positive_pct":{"type":"number"}}},"lag_hours":{"type":"number","description":"Hours the data is deliberately lagged behind live.","example":24.0},"as_of":{"type":"integer","description":"Unix epoch of the snapshot."},"schema":{"type":"string","example":"triad.v1"},"disclaimer":{"type":"string","description":"Full notice; travels with the data."}},"required":["venue","edge_by_lifecycle","overall","lag_hours","as_of","schema"]},"example":{"venue":"kalshi","measure":"Mean observed difference between fill price and the prevailing quote at time of fill, across resting-order executions on the venue, grouped by time to contract resolution.","units":"cents per contract","edge_by_lifecycle":{"90-365d":{"n":95079,"edge_mean_cents":9.92,"positive_pct":97.4},">365d":{"n":52469,"edge_mean_cents":6.71,"positive_pct":72.9}},"overall":{"n":147557,"edge_mean_cents":8.77,"positive_pct":88.7},"lag_hours":24.0,"as_of":1789671967,"schema":"triad.v1"}}}},"402":{"description":"Payment required: $0.02 USDC on eip155:8453 to 0xBc3eb6dc759c0DBBDf0D8351C7Cc8Db3c9191642. Terms are in the PAYMENT-REQUIRED header as base64 JSON."},"429":{"description":"Rate limited."},"503":{"description":"No fresh snapshot. The service fails closed rather than serving stale data as if it were current."}}}},"/v1/regime":{"get":{"operationId":"getRegime","summary":"Current observed market-state label (free)","description":"Free feed, no payment or account. Impersonal market-state data; input classes are named in the methodology, weighting is not disclosed. Not investment advice.","tags":["market-data","free"],"security":[],"responses":{"200":{"description":"Current regime reading.","content":{"application/json":{"schema":{"type":"object","properties":{"regime":{"type":"string","enum":["COMPRESSION","NEUTRAL","STRESS"],"description":"Observed market-state label."},"state_intensity":{"type":"number","minimum":0,"maximum":1,"description":"Magnitude of the observed state (0-1), from market statistics only. Strength of the observation, not a measure of advisability."},"conditions":{"type":"object","description":"Coarse component states."},"sources":{"type":"object","description":"What each published component was read from, keyed the same way as `conditions`. A component that could not be read is not published at all - the feed refuses rather than substituting a neutral default, and this field is how that refusal is auditable rather than merely claimed.","example":{"credit_spreads":"fred_hy_oas","volatility_term_structure":"fred_vix_vix3m"}},"input_as_of":{"type":"object","description":"Date of each underlying observation - NOT when it was fetched. Government series publish with a lag, so a reading made today rests on observations of a few days ago, and the difference matters to anyone comparing this against their own data.","example":{"credit_spreads":"2026-09-23","volatility_term_structure":"2026-09-22"}},"methodology_version":{"type":"string","example":"regime-method.v3"},"methodology_changed_on":{"type":"string","description":"Date the current methodology took effect. The series is not comparable across a change.","example":"2026-09-24"},"methodology_url":{"type":"string"},"as_of":{"type":"integer"},"schema":{"type":"string","example":"regime.v1"},"disclaimer":{"type":"string"}},"required":["regime","as_of","schema"]}}}},"429":{"description":"Rate limited."},"503":{"description":"No fresh snapshot; fails closed."}}}},"/healthz":{"get":{"operationId":"getHealth","summary":"Liveness and snapshot freshness (free)","tags":["free"],"security":[],"responses":{"200":{"description":"Service status."}}}},"/v1/census":{"get":{"summary":"x402 payer census - settled demand, read from chain","description":"Who actually pays x402 sellers on Base, read from chain. Every USDC settlement (EIP-3009) into every seller listed in the x402 catalogue over a trailing seven days: settled volume, real buyers separated from crawlers, how many listed sellers were paid at all and by how many buyers, and which categories are open markets versus a single buyer's pipeline. Aggregates only - no seller, buyer or wallet is identified. A full, real response is free at https://intel.opusai.work/v1/census/sample.","operationId":"getCensus","responses":{"200":{"description":"Census payload (schema x402-census.v1). Free sample: /v1/census/sample"},"402":{"description":"Payment required: $0.25 USDC on eip155:8453 via x402"},"503":{"description":"Census data missing or stale"}}}}}}