Quick start
The free endpoints need no key. Try one now:
curl https://api.opusai.work/v1/risk?chain=base
Paid endpoints take your key in the X-API-Key header:
curl -H "X-API-Key: oai_live_…" \ "https://api.opusai.work/v1/changes?chain=base&since=2026-09-20"
Every response is JSON and carries as_of (Unix time of the snapshot), scope (chain), schema and a disclaimer. Data is rebuilt daily at about 10:30 UTC. An interactive reference lives at /docs.
Endpoints
Where there's a chain parameter, it takes base, ethereum, a chain id, or nothing for all chains.
| Endpoint | Returns | Access |
|---|---|---|
GET /v1/health | Snapshot time, days of history, which change types are tracked | Free |
GET /v1/risk | Venue aggregates: TVL behind oracles Morpho flags unusable, red-flag counts and TVL, zero-fee share, empty vaults | Free |
GET /v1/changes | Every change across all vaults. Filters: since (YYYY-MM-DD), kind, severity, vault, limit, offset | Key |
GET /v1/vaults | Current state of every vault: curator, fee, timelock, TVL, APY, Morpho's red flags. Filters: curator, min_tvl, red_flagged | Key |
GET /v1/vaults/{address}/history | Daily series for one vault since it was first observed | Key |
GET /v1/curators | Per-curator facts: TVL, vault count, TVL-weighted fee, zero-fee share, flags. No score, no rank | Key |
GET /v1/curators/{address} | One curator's vaults and every change to them | Key |
GET /v1/peers | Where an LLTV and utilisation sit among live markets with the same collateral and loan asset. Params: collateral, loan, lltv, utilization | Key |
GET /v1/me | Your tier, today's usage and quota, trial end date | Key |
Errors
401 the key is missing or unknown · 403 the key was revoked or the trial ended · 429 daily quota reached (resets at 00:00 UTC), or the free tier's 30 requests a minute · 503 the data is being rebuilt, so retry in a minute.
Change types
Each change comes from comparing one day's snapshot with the day before. Alerts are the changes a depositor would want to hear about first.
| kind | Meaning | Severity |
|---|---|---|
fee_raised | Performance fee went up | alert |
fee_lowered | Performance fee went down | note |
timelock_shortened | Less notice before the curator can change the vault | alert |
timelock_lengthened | More notice before changes | note |
curator_changed | A named curator replaced by another named curator | alert |
red_flag_gained | Morpho raised a RED warning on the vault | alert |
red_flag_cleared | A RED warning was removed | note |
tvl_drop | Deposits fell 20% or more in a day | alert |
Pricing
Every paid plan starts with a 30-day free trial. Launch subscribers keep their price when list prices rise.
Analyst
- Every endpoint, both chains
- Full history since 2026-09-18
- 10,000 requests a day
Pro
- Everything in Analyst
- Webhook alerts for your vault watchlist (coming after launch)
- 100,000 requests a day
Prices in USD, billed monthly by card through Stripe. Cancel any time; access runs to the end of the paid month.
Data & method
Every vault and market Morpho's public API reports on Ethereum (chain 1) and Base (chain 8453) is snapshotted once a day, around 10:15 UTC. The history can't be rebuilt after the fact, because Morpho's API only reports current state. That's why the series starts on the day recording began.
| Field | Changes visible from |
|---|---|
| Fee, curator, TVL | 2026-09-18 |
| Timelock, Morpho RED flags | 2026-09-21 |
How edge cases are handled
Missing curators. Morpho's API sometimes reports a vault's curator as the zero address, then goes back to the real one. That's treated as "not reported", not as a resignation. The vault keeps the last named curator seen, and no change is recorded.
Implausible APYs. Vaults reporting an APY above 100% are left out of fee estimates, and the number left out is counted in data_quality.
Flags. Warning flags are Morpho's own and are reproduced without independent verification.
Addresses, not identities. Curators are identified only by on-chain address and Morpho's labels.
Every response says which of these caveats applies to it. /v1/changes also carries tracked_since for each field.
Terms of service
Version 1.0 · 22 September 2026 · OpusAI, LLC
Conflict of interest, disclosed. OpusAI, LLC intends to operate a curated vault on Morpho. It would then compete with curators this API describes. Any such vault appears in the API on exactly the same terms as every other, and the API contains no commentary on it.
1. These terms
These terms are an agreement between OpusAI, LLC, a Florida limited liability company ("we", "us"), and the person or entity subscribing ("you"). They apply when you request an API key, use a key, or access any endpoint at api.opusai.work, including the free endpoints. If you are agreeing on behalf of an organisation, you confirm you may bind it. If you do not accept these terms, do not use the service.
2. The service
We record publicly visible configuration and performance data about Morpho vaults and markets, once a day, and serve those recordings and the changes between them ("the data") through the API. What each endpoint returns, and the history behind it, is described on this page and in each response.
3. Not advice, not a rating
The data is factual observation. It is not investment, financial, legal, tax or accounting advice; not a recommendation or solicitation to deposit, withdraw, lend, borrow, buy or sell anything; not an offer of advisory services; and not a rating, ranking, endorsement or assessment of any curator, vault, market, asset or protocol. The same data is served to every subscriber. We do not consider your objectives, circumstances or risk tolerance, and we accept no fiduciary duty to you. Warning flags are Morpho's own, reproduced as reported and without independent verification. Decisions you make, and decisions made by software you control, are yours alone.
4. No warranty
The service and the data are provided "as is" and "as available". To the fullest extent permitted by law we disclaim all warranties, express or implied, including merchantability, fitness for a particular purpose, accuracy, and non-infringement. The data comes from third-party sources that may be incomplete, delayed, revised or wrong, and our recordings inherit those defects. We do not warrant that the service will be uninterrupted, that history will be continuous, or that any figure is correct.
5. Limitation of liability
To the fullest extent permitted by law, our total aggregate liability for all claims arising out of or relating to the service, whether in contract, tort or otherwise, will not exceed the greater of (a) the fees you paid us in the three months before the event giving rise to the claim, or (b) US$100. We will not be liable for indirect, incidental, special, consequential, exemplary or punitive damages, or for lost profits, lost revenue, lost data, or trading or investment losses, even if advised such losses were possible. These limits apply to the maximum extent permitted; some jurisdictions do not allow certain exclusions, in which case the exclusions apply only as far as the law permits.
6. Your responsibilities
- Keep your API key confidential. You are responsible for all use made with it. Tell us promptly if it is exposed and we will revoke and replace it.
- Do not attempt to circumvent quotas, rate limits or access controls, and do not use the service in a way that degrades it for others.
- Use the service only for lawful purposes, and comply with applicable sanctions and export laws.
- Do not represent the data as your own product, or state or imply that we endorse, rate or recommend anything.
7. What you may and may not do with the data
Subject to these terms and to your subscription remaining current, we grant you a non-exclusive, non-transferable, revocable licence, for the term of your subscription, to use the data internally and to publish analysis, commentary, charts and derived figures based on it, with attribution to OpusAI, LLC.
You may not resell, redistribute, sublicense or republish the raw data or substantial or systematic extracts of it; provide the data to third parties as a feed, file, dataset or API; use it to build, train or populate a competing dataset or service; or scrape, cache or store it beyond what your own use requires. We retain all rights in the data, the recordings, the schemas and the service; you retain all rights in what you create from them.
8. Fees, trial and cancellation
Paid plans include a 30-day free trial and are then billed monthly in advance by card through Stripe, our payment processor. Prices are in US dollars and exclude any taxes, which are your responsibility unless we state otherwise. You may cancel at any time; access continues to the end of the paid period and fees already paid are not refunded, except where the law requires. We will give at least 30 days' notice before a price change takes effect for you, and subscribers keep the price they signed up at until then. Non-payment ends access.
9. Changes, suspension and termination
We may add, change or discontinue endpoints and fields, and will give reasonable notice of changes that materially reduce what a paid tier receives. We may suspend or terminate a key immediately for breach of these terms, non-payment, or where required by law, and may terminate any subscription on 30 days' notice, refunding the unused part of the current period. You may stop using the service at any time. Sections 3 to 7, 10 and 11 survive termination.
10. Privacy
We collect only what running the service requires: the name, email and billing details you give Stripe (Stripe processes payments and stores card details; we do not see or store card numbers), and logs of API requests recording the key used, the endpoint, and the time. We use these to operate and support the service and to bill you. We do not sell personal information. Request logs are retained while your subscription is active and for up to 12 months after. Ask us to delete your account data and we will, except where we must keep records for tax or legal reasons.
11. Governing law and disputes
These terms are governed by the laws of the State of Florida, USA, without regard to conflict-of-law rules. The state and federal courts located in Florida have exclusive jurisdiction, and both parties consent to venue there. Each party waives any right to a jury trial and to participate in a class or representative action.
12. General
These terms, plus the description of the service on this page, are the entire agreement between us and replace any earlier version. We may update them, and will post the new version here with a new version number and date; material changes take effect for existing subscribers 30 days after posting, and continued use after that is acceptance. Nothing here creates a partnership, joint venture, employment or agency relationship. Neither party is liable for delays caused by events beyond its reasonable control. If a provision is unenforceable, the rest remains in force. You may not assign these terms without our consent; we may assign them to a successor in connection with a merger or sale of the business. Failure to enforce a provision is not a waiver of it. Notices to us go to the contact address published on this site.