> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pods.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> API updates, new features, and documentation changes

This page tracks significant changes to the Pods 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.

<Warning>
  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.
</Warning>

***

## 2026

### May 2026

**API**

* `GET /v2/swap/quote`: optional `preferredProvider` query parameter to pin which swap provider’s quote is persisted when multiple providers support the route; response remains a single `{ quote }` object (best `expectedAmountOut` when omitted)

**Documentation**

* [Get a Quote](/guides/swaps/get-quote): `preferredProvider`, multi-route aggregation, and related error codes
* OpenAPI (`/v2/swap/quote`): `preferredProvider` parameter and updated endpoint description

### April 2026

**Documentation**

* Documented canonical chain fields (`chainIdIn`, `chainIdOut`, `chainId`) across OpenAPI, swap quote guide, architecture overview, and Cursor route rules—aligned with enriched swap, strategy, and tracking responses
* Documented success-response contract (2xx JSON body, 204, no `success` flag) in OpenAPI intro, Architecture, and Cursor rules
* Documented unified error envelope (removed redundant `httpStatus` in body); aligned [Error Codes](/error-codes) examples and rate-limit payload to live behavior
* OpenAPI and Architecture: document ISO deadlines and strategy quote timestamps; aligned `scripts/generate-docs.js` strategy quote response schema.

**API**

* Added `/transfer/bytecode` to API Reference with canonical `originAddress`/`destinationAddress` and deprecated alias fields (`walletOrigin`, `walletDestination`)
* Standardized success responses: removed `{ success: true/false }` envelopes; invalid API key on `GET /customers/by-api-key` is now **401**; Supabase signup webhook returns **400/409/500** with `HttpError` shape; member delete returns **204**; health and fulfill endpoints return JSON objects instead of bare strings
* Standardized error JSON to `{ error: { code, message, details? } }` across `responser`, auth middlewares, 404/500 handlers, rate limits, and OpenAPI
* Standardized date/time fields in JSON responses to **ISO 8601** (UTC): `GET /v2/swap/quote` `quote.deadlineDate`; wallet history DTOs; top-level dates on `GET /actions/:id`.

### March 2026

**Documentation**

* Added [Why Pods](/getting-started/why-pods) page with competitive differentiation and build-vs-buy comparison
* Added [Fees](/getting-started/fees) page documenting swap fees (25 BPS), yield performance fees (5%), and integrator markup
* Added [Error Codes](/error-codes) reference with 20+ error codes organized by category
* Added `llms.txt` for AI agent discoverability
* Published OpenAPI spec at `docs.pods.finance/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`)
* Aligned list-pagination docs across OpenAPI, Quickstart, yield guide, and examples: `pagination` now documents `total`, `totalPages`, and `hasMore` (replacing mongoose-style `totalRecords` / `hasNextPage` on public responses)
* 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          |