# Deserialize Ultra Aggregator

> One API for DeFi data and actions across six sectors (swaps, memecoins, perps, NFT, prediction markets, RWA) on Solana, Ethereum, Base, Arbitrum, BSC and Polygon. It is read-and-build only: the API never holds funds, never signs and never submits — every action returns an ordered `steps[]` for the user's wallet to sign and send.

Base URL: https://ultra-api.deserialize.xyz — auth is optional (10 req/s free, no key; enterprise keys via sales@deserialize.xyz are unmetered).

Start with Quickstart, then read The steps[] contract before building any action. Everything below is also available concatenated at https://ultra-api.deserialize.xyz/llms-full.txt if you would rather load one file.

Two rules that cause most integration bugs: amounts are decimal strings in base units (never numbers), and quotes expire — re-quote rather than reusing one.

## Docs

- [Quickstart](https://ultra-api.deserialize.xyz/llms/quickstart.md): first calls, the four-step integration path, auth and rate limits, optional SDK
- [Conventions and errors](https://ultra-api.deserialize.xyz/llms/conventions.md): response envelope, amount/address/chain formats, pagination, the closed error-code table
- [The steps contract](https://ultra-api.deserialize.xyz/llms/steps.md): the `steps[]` array — three step kinds, template language, skip conditions, worked examples, safety guarantees
- [Endpoints](https://ultra-api.deserialize.xyz/llms/endpoints.md): every route, generated from the live OpenAPI document
- [Streams and MCP](https://ultra-api.deserialize.xyz/llms/streams.md): WebSocket subscribe protocol and the MCP server for AI agents
- [Sector notes](https://ultra-api.deserialize.xyz/llms/sectors.md): per-sector gotchas for swaps, memecoins, perps, predictions and RWA

## Reference

- [OpenAPI schema](https://ultra-api.deserialize.xyz/v1/openapi.json): machine-readable request/response shapes for every route
- [Complete contract](https://ultra-api.deserialize.xyz/llms-full.txt): all documents above concatenated into one file
- [TypeScript SDK](https://www.npmjs.com/package/@deserialize/ultra-agg-sdk): typed client with a steps[] executor

## Optional

- [Interactive docs](https://ultra-api.deserialize.xyz/docs): Swagger UI for exploring endpoints in a browser
- [Service health](https://ultra-api.deserialize.xyz/v1/health): live status of the API and its infrastructure
- [Provider availability](https://ultra-api.deserialize.xyz/v1/providers): which venue adapters are currently enabled