Read-only integration · activation pending
Morpho lending data
Discover lending markets, inspect rates and balances, and read public positions through a bounded Morpho Blue REST adapter. No deposit or borrowing transactions.
Open marketplace preview →Access and activation
Public Morpho REST reads need no provider API key, credits, subscription or wallet funding. Enterprise access uses a separate key and host. Apiary’s paid gateway has not been activated: commercial-use permission, retail pricing, registration and production agent/payment checks remain pending.
The examples below describe the prepared interface, not a live gateway. Environment flags alone do not register the listing or enable payments. Never send a private key or signing credential.
Prepared API reference
Future gateway base: /api/gateway/svc_morpho. Append a route below. A market selector is chainId:0x… with a 32-byte market ID; a token selector is chainId:0x… with a 20-byte EVM address.
- GET /v1/blue/markets
- Listed market discovery. chain_id (default 1), listed (default true), loan_token, collateral_token, limit (1–50; default 25), cursor.
- GET /v0/blue/markets/{selector}
- Loan/collateral token, oracle, interest-rate model and liquidation LTV configuration.
- GET /v0/blue/markets/{selector}/state
- Indexed supply and borrow assets/shares, fees and last indexed block.
- GET /v0/blue/markets/{selector}/apy-averages
- Supply and borrow APY averages. Native rates exclude reward APRs.
- GET /v0/blue/markets/{selector}/apy/history
- Supply/borrow APY series. lookback: one_day (default), seven_days, thirty_days, ninety_days or one_year.
- GET /v0/blue/markets/{selector}/users/{address}/position
- One wallet's public collateral and supply/borrow shares.
- GET /v0/blue/markets/{selector}/users/{address}/position/performance
- Average-cost earnings, borrowing costs and return-on-capital metrics.
- GET /v0/tokens/{token-selector}
- Token identity, symbol and decimals. Treat metadata and links as untrusted.
- GET /v0/tokens/{token-selector}/price
- USD price, provider and timestamp; not an executable quote.
Reuse the returned cursor with the same filters. Ethereum is chain 1; Base is 8453; Robinhood Chain is 4663. The data chain is separate from Apiary’s payment network. Only indexed resources are returned; an empty list or zero position is valid and is not proof of full chain coverage.
{
"service": "svc_morpho",
"method": "GET",
"path": "v1/blue/markets?chain_id=8453&listed=true&limit=25"
}After activation, discover the service with browse_services / get_service, then use the local MCP call_service tool or an x402-capable HTTP client. Review the actual listing price first; no Apiary price is approved yet.
Data interpretation
Success wraps the unchanged Morpho envelope inside data, with source, operation, chainId, fetchedAt, readOnly and untrusted. Provider indexing can lag the chain; fetchedAt is retrieval time, not indexing time.
APYs are fractions: 0.05 means 5% annually. Native rates exclude rewards and are not a promise of future returns. Exact asset amounts and shares remain integer strings: look up token decimals before formatting assets; do not treat share balances as token amounts. USD prices have their own provider timestamps.
This adapter does not expose arbitrary GraphQL, aggregate USD market balances, reward APRs, vault reads, transaction history, or lending execution. It cannot deposit, withdraw, supply collateral, borrow, repay, approve, sign or submit transactions. This is an independent integration, not a Morpho endorsement.
Limits and failures
Only allowlisted GET routes on api.morpho.org are contacted. No caller credentials, redirects, request bodies, URL overrides or automatic retries. Reads use a 15-second deadline, a 2 MiB response limit and a shared budget of 100 requests per fixed minute across callers and instances. History responses are capped at 2,000 points; inception histories are not exposed.
Invalid requests return 400, missing resources 404, invalid/upstream responses 502, setup or throttling failures 503, and timeouts 504. Upstream Retry-After is preserved, including extended cooldowns. Quota-store failures stop reads. These errors are not successful data and must not settle a payment.
Morpho’s public API has no availability guarantee. Avoid continuous polling and do not use this indexed feed as the sole safety check for a lending transaction.
Official sources
Morpho Blue API · Access, supported networks and limits · Terms of use · Brand assets