> ## Documentation Index > Fetch the complete documentation index at: https://docs.compasslabs.ai/llms.txt > Use this file to discover all available pages before exploring further. # List pendle markets > List Pendle yield trading markets with TVL and implied APY. Returns Pendle market data including Principal Token (PT), Standardized Yield (SY), and Yield Token (YT) addresses, along with market expiry, TVL, and implied APY. Use this endpoint to discover yield trading opportunities, compare rates across Pendle markets, or build market selection interfaces. APY values are returned in percentage format (e.g., 5.25 means 5.25%). Markets without complete metadata or statistics are excluded. ## OpenAPI ````yaml /v2/combined_spec.json get /v2/earn/pendle_markets openapi: 3.1.0 info: title: Compass API description: Compass Labs DeFi API version: 0.0.1 servers: - url: https://api.compasslabs.ai description: Production server security: - ApiKeyAuth: [] paths: /v2/earn/pendle_markets: get: tags: - Earn summary: List pendle markets description: >- List Pendle yield trading markets with TVL and implied APY. Returns Pendle market data including Principal Token (PT), Standardized Yield (SY), and Yield Token (YT) addresses, along with market expiry, TVL, and implied APY. Use this endpoint to discover yield trading opportunities, compare rates across Pendle markets, or build market selection interfaces. APY values are returned in percentage format (e.g., 5.25 means 5.25%). Markets without complete metadata or statistics are excluded. operationId: v2_earn_pendle_markets parameters: - name: order_by in: query required: true schema: type: string title: Order By default: tvl_usd description: The field to order the results by. - name: direction in: query required: false schema: type: string enum: - asc - desc title: Direction default: desc description: The direction to order the results by. - name: offset in: query required: false schema: type: integer default: 0 title: Offset description: The offset of the first item to return. - name: limit in: query required: false schema: type: integer maximum: 1000 exclusiveMinimum: 0 default: 50 title: Limit description: The number of items to return. - name: chain in: query required: false schema: anyOf: - $ref: '#/components/schemas/Chain' - type: 'null' title: Chain default: null description: >- Optional chain filter. If not provided, returns markets for all chains. - name: underlying_symbol in: query required: false schema: anyOf: - type: string - type: 'null' title: Underlying Symbol description: Filter markets by underlying asset symbol (e.g., 'USDC', 'WETH'). - name: min_tvl_usd in: query required: false schema: anyOf: - type: number - type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ - type: 'null' title: Min Tvl Usd description: >- Minimum TVL in USD. Markets with TVL below this value will be excluded. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PendleMarketsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' x-codeSamples: - lang: python label: Python (SDK) source: |- from compass_api_sdk import CompassAPI, models with CompassAPI( api_key_auth="", ) as compass_api: res = compass_api.earn.earn_pendle_markets(order_by="tvl_usd", direction=models.V2EarnPendleMarketsDirection.DESC, offset=0, limit=50) # Handle response print(res) - lang: typescript label: Typescript (SDK) source: |- import { CompassApiSDK } from "@compass-labs/api-sdk"; const compassApiSDK = new CompassApiSDK({ apiKeyAuth: "", }); async function run() { const result = await compassApiSDK.earn.earnPendleMarkets({ orderBy: "tvl_usd", direction: "desc", offset: 0, limit: 50, }); console.log(result); } run(); components: schemas: Chain: type: string enum: - base - ethereum - arbitrum - hyperevm - tempo - bsc title: Chain description: The chain to use. PendleMarketsResponse: properties: total: type: integer title: Total offset: type: integer title: Offset limit: type: integer title: Limit markets: items: $ref: '#/components/schemas/PendleMarketInfo' type: array title: Markets description: A list of Pendle market information objects. example: - chain: ethereum expiry: 1735689600 implied_apy: '8.52' market_address: '0x7d372819240D14fB477f17b964f95F33BeB4c704' pt_address: '0xc69Ad9baB1dEE23F4605a82b3354F8E40d1E5966' pt_name: PT weETH 26DEC2024 pt_symbol: PT-weETH-26DEC2024 sy_address: '0xAC0047886a985071476a1186bE89222659970d65' tvl_usd: '45000000.00' underlying_asset: '0xCd5fE23C85820F7B72D0926FC9b05b43E359b7ee' underlying_name: Wrapped eETH underlying_symbol: weETH yt_address: '0xfb35Fd0095dD1096b1Ca49AD44d8C5812A201677' - chain: arbitrum expiry: 1743465600 implied_apy: '12.35' market_address: '0xD0354D4e7bCf345fB117cabe41aCaDb724eccA91' pt_address: '0x1c27Ad8a19Ba026ADaBD615F6Bc77158130cfBE4' pt_name: PT ezETH 27MAR2025 pt_symbol: PT-ezETH-27MAR2025 sy_address: '0x80c12D5b6Cc494632Bf11b03F09436c8B61Cc5Df' tvl_usd: '28500000.00' underlying_asset: '0x35751007a407ca6FEFfE80b3cB397736D2cf4dbe' underlying_name: Renzo Restaked ETH underlying_symbol: ezETH yt_address: '0x0000000000000000000000000000000000000000' type: object required: - total - offset - limit - markets title: PendleMarketsResponse description: Response model for a paginated list of Pendle markets. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PendleMarketInfo: properties: market_address: type: string title: Market Address description: The Pendle market contract address. examples: - '0x7d372819240D14fB477f17b964f95F33BeB4c704' chain: type: string title: Chain description: Blockchain name (e.g., 'ethereum', 'arbitrum'). pt_address: type: string title: Pt Address description: The Principal Token (PT) address. sy_address: anyOf: - type: string - type: 'null' title: Sy Address description: The Standardized Yield (SY) token address. yt_address: anyOf: - type: string - type: 'null' title: Yt Address description: The Yield Token (YT) address. expiry: anyOf: - type: integer - type: 'null' title: Expiry description: The market maturity timestamp (Unix epoch seconds). underlying_asset: anyOf: - type: string - type: 'null' title: Underlying Asset description: The underlying asset contract address. underlying_name: anyOf: - type: string - type: 'null' title: Underlying Name description: The name of the underlying asset. underlying_symbol: anyOf: - type: string - type: 'null' title: Underlying Symbol description: The symbol of the underlying asset (e.g., 'USDC'). pt_name: anyOf: - type: string - type: 'null' title: Pt Name description: The name of the Principal Token. pt_symbol: anyOf: - type: string - type: 'null' title: Pt Symbol description: The symbol of the Principal Token. tvl_usd: anyOf: - type: string - type: 'null' title: Tvl Usd description: Total Value Locked in USD. implied_apy: anyOf: - type: string - type: 'null' title: Implied Apy description: Implied APY as a percentage (e.g., 5.25 = 5.25%). additionalProperties: false type: object required: - market_address - chain - pt_address title: PendleMarketInfo description: Information about a single Pendle market from the database. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your Compass API Key. Get your key [here](https://www.compasslabs.ai/dashboard). ````