Fixed Earn

Fixed Earn gives users a known rate until a maturity date, the on-chain equivalent of a fixed-term deposit. It runs on Pendle principal tokens (PT): a PT is bought below its face value and redeems at full value on its maturity date, and that discount is the yield. You pick a market, the API builds the purchase, and the position is tracked like any other Earn position. Fixed Earn is available on Ethereum, Base and Arbitrum. It uses the same Earn Account and the same manage call as Earn, with a PENDLE_PT venue.

Before you start

An API key. See the Quick Start.
An Earn Account for the user on the chain you want, holding the token to spend, such as USDC. See Create an Account and Fund an Account.

1. Find a market

Each Pendle market has an underlying asset, a maturity date and an implied APY, the fixed rate a new buyer gets today:

import os
from compass_api_sdk import CompassAPI

compass = CompassAPI(api_key_auth=os.environ["COMPASS_API_KEY"])

markets = compass.earn.earn_pendle_markets(
    chain="base", order_by="tvl_usd"
).markets

for market in markets:
    print(market.market_address, market.underlying_symbol, market.implied_apy)

import { CompassApiSDK } from "@compass-labs/api-sdk";

const compass = new CompassApiSDK({ apiKeyAuth: process.env.COMPASS_API_KEY });

const { markets } = await compass.earn.earnPendleMarkets({
  chain: "base",
  orderBy: "tvl_usd",
});

for (const market of markets) {
  console.log(market.marketAddress, market.underlyingSymbol, market.impliedApy);
}

curl "https://api.compasslabs.ai/v2/earn/pendle_markets?chain=base&order_by=tvl_usd" \
  -H "x-api-key: $COMPASS_API_KEY"

Read market_address (what you pass when depositing), underlying_symbol, implied_apy (a percentage) and expiry (a Unix timestamp). Filter with underlying_symbol or min_tvl_usd.

2. Deposit

Spend 100 USDC from the user’s Earn Account on the PT of a market:

deposit = compass.earn.earn_manage(
    owner="0xYourWalletAddress",
    chain="base",
    venue={
        "type": "PENDLE_PT",
        "market_address": "0xMarketAddress",
        "token": "USDC",
        "max_slippage_percent": 1,
    },
    action="DEPOSIT",
    amount="100",
)

# deposit.transaction: unsigned tx for the owner to sign and send

const deposit = await compass.earn.earnManage({
  owner: "0xYourWalletAddress",
  chain: "base",
  venue: {
    type: "PENDLE_PT",
    marketAddress: "0xMarketAddress",
    token: "USDC",
    maxSlippagePercent: 1,
  },
  action: "DEPOSIT",
  amount: "100",
});

// deposit.transaction: unsigned tx for the owner to sign and send

curl -X POST "https://api.compasslabs.ai/v2/earn/manage" \
  -H "x-api-key: $COMPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "owner": "0xYourWalletAddress",
    "chain": "base",
    "venue": {
      "type": "PENDLE_PT",
      "market_address": "0xMarketAddress",
      "token": "USDC",
      "max_slippage_percent": 1
    },
    "action": "DEPOSIT",
    "amount": "100"
  }'

Field	Description
`venue.market_address`	The market from step 1.
`venue.token`	The token to spend, for example `USDC`. It’s exchanged for the PT in the same transaction. Deposits only.
`venue.max_slippage_percent`	The most the exchange into the PT may slip, in percent. Defaults to `1`.
`amount`	For a deposit, how much of `token` to spend. For a withdrawal, how many PT to sell.
`fee`, `gas_sponsorship`	Optional, as on any Earn deposit. See Embedded Fees and Gas Sponsorship.

The user signs transaction and sends it. The PT sits in the Earn Account until maturity, or until the user sells.

3. Track the position

positions = compass.earn.earn_positions(
    chain="base", owner="0xYourWalletAddress"
)

for pt in positions.pendle_pt:
    print(pt.market_address, pt.pt_balance, pt.expiry, pt.usd_value)

const positions = await compass.earn.earnPositions({
  chain: "base",
  owner: "0xYourWalletAddress",
});

for (const pt of positions.pendlePt ?? []) {
  console.log(pt.marketAddress, pt.ptBalance, pt.expiry, pt.usdValue);
}

curl "https://api.compasslabs.ai/v2/earn/positions?chain=base&owner=0xYourWalletAddress" \
  -H "x-api-key: $COMPASS_API_KEY"

Fixed Earn positions are listed under pendle_pt. Each has pt_balance, expiry, usd_value, the market’s current implied_apy, and a pnl block. The user’s own rate was fixed by the price they paid. implied_apy is today’s rate for new buyers, so show it as a market rate, not as the user’s return.

4. Withdraw

Call manage with action: "WITHDRAW", the same market_address, and amount set to the number of PT to sell. Leave out venue.token. The payout is always USDC, sent to the Earn Account:

Before maturity, the PT is sold at the current market price, so the user gets less than face value.
At or after maturity, the PT is redeemed at full value.

Then send the USDC to the user’s wallet with transfer. See Withdraw Funds.

Good to know

The rate is fixed only if held to maturity. Show the maturity date next to the rate, and tell users that an early exit is at market price.
Markets expire. Pick markets with enough time left for your product, and give users a way to move into a new market once one matures.
PnL is measured in the market’s yield units (SY), not USD. Use usd_value for a dollar figure. See How Yield Accrues.

Endpoints

Endpoint	Use it to
`GET /v2/earn/pendle_markets`	List markets with implied APY, TVL and maturity.
`POST /v2/earn/manage`	Buy or sell a PT with the `PENDLE_PT` venue.
`GET /v2/earn/positions`	Read positions, including `pendle_pt`.

Earn

Variable yield from Aave, Morpho and Euler.

Embedded Fees

Earn a fee on every deposit or withdrawal.

Gas Sponsorship

Pay gas for your users so they never need ETH.

Get Started

Products

Data

Account Lifecycle

Platform Concepts

Developer Tools

Resources

Before you start

1. Find a market

2. Deposit

3. Track the position

4. Withdraw

Good to know

Endpoints

Next

Earn

Embedded Fees

Gas Sponsorship

​Before you start

​1. Find a market

​2. Deposit

​3. Track the position

​4. Withdraw

​Good to know

​Endpoints

​Next

Earn

Embedded Fees

Gas Sponsorship

Before you start

1. Find a market

2. Deposit

3. Track the position

4. Withdraw

Good to know

Endpoints

Next