API documentation
The Tenor API returns quotes and ready-to-sign transactions for lending and borrowing on Morpho, at fixed or variable rates. Tenor does not hold your keys. Your wallet, Safe or custodian signs and sends every transaction.
https://tenor-api.tenor.finance
How it works
- Find a market.
GET /v1/marketsreturns every market with its open maturities. - Quote.
POST /v1/quotesreturns the rate at which the open offers would currently fill an amount, fees included. - Prepare.
POST /v1/lend/prepare(or borrow, repay, and so on) returns the transactions to sign. The API simulates the transactions first and runs the checks listed in Concepts. - Sign and send from your wallet.
- Track.
GET /v1/transactions/{tx_hash}returns the transaction status and the offers filled.
You do not need a key to read data or get quotes. You need one to prepare transactions.
Guides
Quote fixed rates
Show the fixed rate for a given amount on every maturity in a wallet, dashboard or aggregator, without an API key.
Post an offer at your rate
Post lend and borrow offers at your own rate, then track and cancel the offers.
Get started
Quickstart
Lend at a fixed rate with a short TypeScript script, from the quote to the confirmed position.
API clients
Official TypeScript and Python clients, with typed methods for every endpoint, retries and structured errors.
API keys
You do not need an API key: every endpoint except GET /v1/access works without one, on per-IP rate limits. A key gives you higher, per-key limits. The Tenor team issues API keys for your organization: email contact@tenor.finance.
Each key has scopes: read for private reads, such as readiness checks, and trade for preparing transactions. You can also ask for a test key, which starts with tnr_sk_test_. A test key works like a normal key, but every prepare is a dry run, so you never get anything to send.
Resources
- API reference: the interactive reference.
- API clients: official TypeScript and Python clients.
- OpenAPI document: to generate a typed client.
- llms.txt: the whole API in one Markdown file, for AI coding tools.
- Contract addresses: the contracts your transactions call.