This page tracks significant changes to the Deframe API and documentation.
API Versioning
The current stable API version is v2. Swap endpoints use the /v2/ prefix (e.g., /v2/swap/quote). Strategy and wallet endpoints do not use a version prefix.
Legacy swap endpoints without the /v2/ prefix are deprecated and will be removed in a future release. Always use /v2/swap/quote, /v2/swap/bytecode, and /v2/swap/status/{id} for new integrations.
2026
March 2026
Documentation
- Added Why Deframe page with competitive differentiation and build-vs-buy comparison
- Added Fees page documenting swap fees (25 BPS), yield performance fees (5%), and integrator markup
- Added Error Codes reference with 20+ error codes organized by category
- Added
llms.txt for AI agent discoverability
- Published OpenAPI spec at
docs.deframe.io/openapi.yaml
- Linked status page from Architecture and API Reference pages
- Fixed rate limit documentation: aligned to 100 req/min, 1,000 req/hr per API key across all pages
- Added
.env template and walletAddress setup to Quickstart
- Fixed strategy response shapes in docs to match live API (
data pagination, flat asset field, composite id)
- Updated all swap code examples to use
/v2/ endpoints
API
- Added cross-chain investment support
- Added Lido staking strategies (ETH and USD)
- Added covered savings xDAI strategy
- Added fee administration endpoints for integrators
- Fixed Lido addresses and ABIs
- Fixed withdraw history tracking
- Removed
request-lend action
February 2026
Documentation
- Added iframe integration guides (Privy, wagmi/viem)
- Added EarnWidget and SwapWidget documentation
- Added LLM playbook for AI tool integration
- Added external integration guides (Privy, Fireblocks, Dynamic)
January 2026
API
- Launched v2 swap endpoints (
/v2/swap/quote, /v2/swap/bytecode, /v2/swap/status/{id})
- Added strategy analytics endpoint
- Added wallet transaction history endpoint (
/wallets/{wallet}/history/{strategyId})
- Added Sepolia testnet support for Aave strategies
- Added Base network strategies
Documentation
- Migrated documentation to Mintlify
- Added yield guides (check protocol info, deposit, check positions, withdraw)
- Added swap guides (get quote, execute swap)
- Added JavaScript code examples (strategy deposit, same-chain swap, cross-chain swap)
Deprecation Notices
| Endpoint | Status | Replacement | Removal Date |
|---|
GET /swap/quote | Deprecated | GET /v2/swap/quote | TBD |
POST /swap/bytecode | Deprecated | POST /v2/swap/bytecode | TBD |
GET /swap/status/{id} | Deprecated | GET /v2/swap/status/{id} | TBD |
