Skip to main content

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​

  1. Find a market. GET /v1/markets returns every market with its open maturities.
  2. Quote. POST /v1/quotes returns the rate at which the open offers would currently fill an amount, fees included.
  3. 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.
  4. Sign and send from your wallet.
  5. 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.

Passive quoting

Quote lend and exit rates on every maturity of a market from one curve.

Get started​

Quickstart

Lend at a fixed rate with a short TypeScript script, from the quote to the confirmed position.

Concepts

How quotes, transactions, wallet kinds, rate limits, errors and units work.

API reference

Every endpoint, field and error code, with a client to try requests.

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​