Idle Finance website screenshot

Idle Finance

Idle Finance is a decentralized yield automation protocol that has operated since 2019, enabling users and integrators to optimize yield generation across DeFi. The platform offers REST APIs for querying Best Yield and Yield Tranches pools, APY and TVL metrics, historical rates, and governance staking information. Idle aggregates yield sources across protocols such as Compound, Aave, Morpho, and Clearpool, and supports multiple chains including Ethereum, Polygon, Polygon zkEVM, and Optimism.

Idle Finance publishes 3 APIs on the APIs.io network: Pools API, Rates API, and TVL API. Tagged areas include DeFi, Yield Optimization, Finance, Crypto, and Staking.

The Idle Finance catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Idle Finance’s developer surface includes authentication, documentation, status page, engineering blog, and 12 more developer resources.

48.6/100 developing ▬ flat Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessSelf serve
5 APIs
DeFiYield OptimizationFinanceCryptoStakingGovernanceTVLAPY

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 48.6/100 · developing
Contract Quality 17.1 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 0.7 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/idle: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Idle Finance Polygon zkEVM API

Idle Finance REST API endpoint for Polygon zkEVM network, providing pool and TVL data for Yield Tranches vaults deployed on Polygon zkEVM.

Idle Finance Optimism API

Idle Finance REST API endpoint for the Optimism network, providing pool and TVL data for Yield Tranches vaults deployed on Optimism.

Idle Finance Pools API

Best Yield and Yield Tranches vault pool data

Idle Finance Rates API

Historical daily yield rate data for Best Yield vaults

Idle Finance TVL API

Total value locked metrics per underlying token

Pricing Plans 1

Published pricing tiers and plan structures.

Plans

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Idle Finance Context

0 classes · 0 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Idle Finance API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Pool

8 properties

JSON SCHEMA

RateRecord

4 properties

JSON SCHEMA

UnderlyingAllocation

3 properties

JSON SCHEMA

Examples 3

Example request and response payloads for these APIs.

Get Pools

4 fields

EXAMPLE

Get Rates By Address

4 fields

EXAMPLE

Get Tvls

4 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Idle Authentication

http · 1 scheme

SECURITY

Idle Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Idle Agentic Access

3 operations

3 operations · 0 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 2

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
name: Idle Finance
description: Idle Finance is a decentralized yield automation protocol that has operated since 2019, enabling users and integrators
  to optimize yield generation across DeFi. The platform offers REST APIs for querying Best Yield and Yield Tranches pools,
  APY and TVL metrics, historical rates, and governance staking information. Idle aggregates yield sources across protocols
  such as Compound, Aave, Morpho, and Clearpool, and supports multiple chains including Ethereum, Polygon, Polygon zkEVM,
  and Optimism.
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/idle.png
url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/apis.yml
created: '2026-06-14'
modified: '2026-06-14'
specificationVersion: '0.19'
tags:
- DeFi
- Yield Optimization
- Finance
- Crypto
- Staking
- Governance
- TVL
- APY
apis:
- name: Idle Finance Polygon zkEVM API
  description: Idle Finance REST API endpoint for Polygon zkEVM network, providing pool and TVL data for Yield Tranches vaults
    deployed on Polygon zkEVM.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.idle.finance/developers/api
  baseURL: https://api-zkevm.idle.finance
  tags:
  - Polygon zkEVM
  - Pools
  - TVL
  - Yield Tranches
  properties:
  - type: Documentation
    url: https://docs.idle.finance/developers/api
  contact:
  - FN: Idle Finance Developer Access
    url: https://idlefinance.typeform.com/to/CzRkDH
    email: ''
- name: Idle Finance Optimism API
  description: Idle Finance REST API endpoint for the Optimism network, providing pool and TVL data for Yield Tranches vaults
    deployed on Optimism.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.idle.finance/developers/api
  baseURL: https://api-optimism.idle.finance
  tags:
  - Optimism
  - Pools
  - TVL
  - Yield Tranches
  properties:
  - type: Documentation
    url: https://docs.idle.finance/developers/api
  contact:
  - FN: Idle Finance Developer Access
    url: https://idlefinance.typeform.com/to/CzRkDH
    email: ''
- aid: idle:idle-pools-api
  name: Idle Finance Pools API
  description: Best Yield and Yield Tranches vault pool data
  humanURL: https://docs.idle.finance/developers/api
  baseURL: https://api.idle.finance
  tags:
  - Pools
  properties:
  - type: OpenAPI
    url: openapi/idle-pools-api-openapi.yml
  - type: Documentation
    url: https://docs.idle.finance/developers/api
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/finops/finops.yml
- aid: idle:idle-rates-api
  name: Idle Finance Rates API
  description: Historical daily yield rate data for Best Yield vaults
  humanURL: https://docs.idle.finance/developers/api
  baseURL: https://api.idle.finance
  tags:
  - Rates
  properties:
  - type: OpenAPI
    url: openapi/idle-rates-api-openapi.yml
  - type: Documentation
    url: https://docs.idle.finance/developers/api
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/finops/finops.yml
- aid: idle:idle-tvl-api
  name: Idle Finance TVL API
  description: Total value locked metrics per underlying token
  humanURL: https://docs.idle.finance/developers/api
  baseURL: https://api.idle.finance
  tags:
  - TVL
  properties:
  - type: OpenAPI
    url: openapi/idle-tvl-api-openapi.yml
  - type: Documentation
    url: https://docs.idle.finance/developers/api
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/idle/refs/heads/main/finops/finops.yml
common:
- type: AgenticAccess
  url: agentic-access/idle-agentic-access.yml
- type: DomainSecurity
  url: security/idle-domain-security.yml
- type: Authentication
  url: authentication/idle-authentication.yml
- type: Documentation
  url: https://docs.idle.finance/developers/introduction
- type: Authentication
  url: https://idlefinance.typeform.com/to/CzRkDH
- type: GitHubOrganization
  url: https://github.com/Idle-Finance
- type: Governance
  url: https://gov.idle.finance
- type: Governance Tally
  url: https://tally.xyz/gov/idle
- type: Bug Bounty
  url: https://immunefi.com/bounty/idlefinance/
- type: Status
  url: https://status.idle.finance
- type: Discord
  url: https://discord.gg/mpySAJp
- type: Twitter
  url: https://twitter.com/idlefinance
- type: Blog
  url: https://medium.com/idle-finance
- type: Website
  url: https://idle.finance
- type: TermsOfService
  url: https://idle.finance/terms
- type: PrivacyPolicy
  url: https://idle.finance/privacy
maintainers:
- FN: API Evangelist
  url: https://apievangelist.com
  email: info@apievangelist.com