# Endpoints

Generated from the live OpenAPI document, so this list cannot drift. Full
machine-readable request/response schemas: https://ultra-api.deserialize.xyz/v1/openapi.json — interactive: https://ultra-api.deserialize.xyz/docs

## fees

- `GET /v1/fees/summary` — Integrator fees accrued on built actions, grouped by token (scoped)

## memecoins

- `GET /v1/memecoins/graduating` — Bonding curves close to graduation
- `GET /v1/memecoins/new` — Newest launches
- `GET /v1/memecoins/tokens/{chain}/{address}` — Single memecoin detail (curve progress, status, mcap)
- `GET /v1/memecoins/trending` — Trending by activity
- `POST /v1/memecoins/{venue}/buy` — Build a bonding-curve buy transaction
- `POST /v1/memecoins/{venue}/sell` — Build a bonding-curve sell transaction

## meta

- `GET /v1/chains` — Supported chains
- `GET /v1/health` — Service + infrastructure health
- `GET /v1/providers` — Provider availability (key-gated adapters)

## other

- `DELETE /mcp` — 
- `GET /llms-full.txt` — 
- `GET /llms.txt` — 
- `GET /llms/{doc}` — 
- `GET /mcp` — 
- `GET /v1/openapi.json` — 
- `POST /mcp` — 

## perps

- `GET /v1/perps/venues` — Perps venues + capabilities
- `GET /v1/perps/{venue}/markets/{marketId}/funding` — Funding + open interest
- `GET /v1/perps/{venue}/markets/{marketId}/orderbook` — L2 orderbook snapshot
- `GET /v1/perps/{venue}/markets` — Markets for a venue
- `GET /v1/perps/{venue}/orders/{owner}` — Open orders (live, uncached)
- `GET /v1/perps/{venue}/positions/{owner}` — Open positions (live, uncached)
- `POST /v1/perps/{venue}/collateral` — Build an isolated-margin collateral add/remove action
- `POST /v1/perps/{venue}/margin` — Build a leverage / margin-mode config action
- `POST /v1/perps/{venue}/orders/build` — Build an order (market/limit, optional TP/SL legs) as signable steps
- `POST /v1/perps/{venue}/orders/cancel` — Build an order-cancel action

## predictions

- `GET /v1/predictions/compare` — Same-event markets matched across venues (slug/fuzzy; never auto-merged)
- `GET /v1/predictions/markets` — Unified market list across all venues (per-venue degradation, never a 500)
- `GET /v1/predictions/venues` — Prediction venues with capabilities (data-only venues are tradable:false)
- `GET /v1/predictions/{venue}/markets/{marketId}/odds` — Current odds per outcome (5s cache)
- `GET /v1/predictions/{venue}/markets/{marketId}/orderbook` — YES-side orderbook (probability prices; outcomeId query selects another outcome)
- `GET /v1/predictions/{venue}/markets` — Prediction markets
- `GET /v1/predictions/{venue}/positions/{owner}` — Outcome-share positions (live, uncached)
- `POST /v1/predictions/{venue}/claims/build` — Build the claim (redeem winnings) transaction for a resolved market
- `POST /v1/predictions/{venue}/onboarding` — Build the one-time onboarding steps (allowances + CLOB credentials)
- `POST /v1/predictions/{venue}/orders/build` — Build a signed-order flow for an outcome (full steps incl. credentials)

## rwa

- `GET /v1/rwa/assets/{id}/yield-history` — Historical APY + TVL series (daily) for yield-bearing assets
- `GET /v1/rwa/assets/{id}` — One RWA asset ({chain}:{address})
- `GET /v1/rwa/assets` — Curated RWA registry with live prices (filter by category/chain/tradability)
- `GET /v1/rwa/categories` — RWA categories with asset counts
- `POST /v1/rwa/build` — Build a buy/sell transaction for a tradable RWA
- `POST /v1/rwa/quote` — Quote buying/selling a tradable RWA via the swap engine

## swaps

- `GET /v1/swaps/providers` — Swap providers per chain
- `POST /v1/swaps/build` — Build swap transaction steps via the best (or pinned) provider
- `POST /v1/swaps/quote` — Meta-aggregated swap quote (all providers, best first)

## tokens

- `GET /v1/tokens/{chain}/{address}/price` — Spot price (USD), 10s cache
- `GET /v1/tokens/{chain}/{address}` — Token metadata (registry-backed, lazily populated)