Endpoints
GraphQL API: For all data related to Iris loans, positions, and bonds. You can explore the schema and run live queries in the GraphQL Playground.Key Data & Features
- Real-time Data: Access current state data for loans, positions, and solver bonds.
- Loan & Position Analytics: Retrieve metrics like fixed rates, maturities, accrued interest, and bond health.
- User Positions: Fetch detailed information on collateral, debt, and bond positions for any borrower or solver.
- Historical Data: Per-position event history and per-market venue index snapshots, to rebuild rates and legs over time.
- Governance: Timelock operation events, to follow owner changes from scheduling to execution.
Supported Networks
The Iris API serves Ethereum mainnet (Chain ID: 1). To test an integration without mainnet funds, run a local mainnet fork and read its state onchain with the SDK. Transactions on a fork never reach mainnet, so the API does not see them.Iris API main rules
Best Practices & Rate Limiting
To ensure reliable service for all users and protect against malicious usage, spam, and attacks, the API enforces the following rate limits:
Limits are bucketed by route and method over a 1-second window. Every response carries the current budget:
429. To stay within the limits and ensure optimal performance for your application:
- Cache Responses: Cache API query results on your backend to reduce redundant requests and improve your application’s performance.
- Request Only What You Need: Structure your GraphQL queries to fetch only the data fields required for your use case.
- Avoid Excessive Polling: Design your application to fetch data efficiently, respecting API limits to prevent interruptions.

