VeloraDEX · andriy-shymkiv · May 27, 2026 · May 27, 2026 · May 27, 2026 · May 27, 2026
diff --git a/api-reference/delta-v2/agents-list.mdx b/api-reference/delta-v2/agents-list.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/agents/list/{chainId}"
+description: "List the active solver agents competing in the auction for a chain. Use the names to filter pricing via includeAgents / excludeAgents."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/agents/list/{chainId}"
+---
diff --git a/api-reference/delta-v2/bridge-protocols.mdx b/api-reference/delta-v2/bridge-protocols.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/prices/bridge-protocols"
+description: "Active bridge protocols (slug, display name, icon) for rendering a bridge picker."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/prices/bridge-protocols"
+---
diff --git a/api-reference/delta-v2/bridge-routes.mdx b/api-reference/delta-v2/bridge-routes.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/prices/bridge-routes"
+description: "Crosschain bridge-route catalogue: every supported (srcChainId, destChainId, tokens) triple."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/prices/bridge-routes"
+---
diff --git a/api-reference/delta-v2/is-token-supported.mdx b/api-reference/delta-v2/is-token-supported.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/prices/is-token-supported"
+description: "Quick yes/no check for token support on a chain."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/prices/is-token-supported"
+---
diff --git a/api-reference/delta-v2/orders-build.mdx b/api-reference/delta-v2/orders-build.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/orders/build"
+description: "Server-built EIP-712 typed data ready to sign. Pass the route from /delta/v2/prices verbatim."
+openapi: "/api-reference/specs/delta-v2.json POST /delta/v2/orders/build"
+---
diff --git a/api-reference/delta-v2/orders-cancel.mdx b/api-reference/delta-v2/orders-cancel.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/orders/cancel"
+description: "Cancel one or more open Delta V2 orders by ID."
+openapi: "/api-reference/specs/delta-v2.json POST /delta/v2/orders/cancel"
+---
diff --git a/api-reference/delta-v2/orders-fillable-balance.mdx b/api-reference/delta-v2/orders-fillable-balance.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/orders/fillablebalance/{chainId}/{userAddress}"
+description: "User's source-token balance minus any amounts already committed to open limit orders. Use it when sizing a new limit order."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/orders/fillablebalance/{chainId}/{userAddress}/{tokenAddress}"
+---
diff --git a/api-reference/delta-v2/orders-get-by-hash.mdx b/api-reference/delta-v2/orders-get-by-hash.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/orders/hash/{hash}"
+description: "Fetch a Delta V2 order by its EIP-712 hash — useful before the order id is assigned."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/orders/hash/{hash}"
+---
diff --git a/api-reference/delta-v2/orders-get-by-id.mdx b/api-reference/delta-v2/orders-get-by-id.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/orders/{orderId}"
+description: "Fetch a Delta V2 order by its UUID — the id returned by POST /delta/v2/orders."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/orders/{orderId}"
+---
diff --git a/api-reference/delta-v2/orders-list.mdx b/api-reference/delta-v2/orders-list.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/orders"
+description: "Paginated list of a user's Delta V2 orders, filterable by chain, status, type, and on-chain order type."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/orders"
+---
diff --git a/api-reference/delta-v2/orders-submit.mdx b/api-reference/delta-v2/orders-submit.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/orders"
+description: "Submit a signed Delta V2 order. The relayer validates signature, balance, and allowance, then enrolls it into the sealed-bid auction."
+openapi: "/api-reference/specs/delta-v2.json POST /delta/v2/orders"
+---
diff --git a/api-reference/delta-v2/overview.mdx b/api-reference/delta-v2/overview.mdx
@@ -0,0 +1,65 @@
+---
+title: "Delta V2 API"
+description: "Server-built EIP-712 orders, route-based pricing with alternatives, paginated history, and a unified status model. Recommended path for new Delta integrations."
+keywords: ["delta", "delta v2", "api-reference"]
+---
+
+Delta V2 is the recommended path for Delta integrations. The on-chain contracts and settlement model are identical to [Delta V1](/api-reference/delta/overview); the protocol surface changes for the better:
+
+- **Server-built orders.** `POST /delta/v2/orders/build` returns EIP-712 typed data ready to sign — clients don't compose `domain`, `types`, and `value` locally.
+- **Route-based pricing.** `GET /delta/v2/prices` returns a recommended `route` plus `alternatives` so users can pick a different bridge or path.
+- **Paginated history.** `GET /delta/v2/orders` returns `{ data, total, page, limit, hasMore }`.
+- **Unified status model.** Eleven values (`PENDING`, `AWAITING_SIGNATURE`, `ACTIVE`, `SUSPENDED`, `CANCELLING`, `BRIDGING`, `COMPLETED`, `FAILED`, `EXPIRED`, `CANCELLED`, `REFUNDED`) replace the V1 split between `status` + `bridgeStatus`.
+- **Server-resolved partner fee.** Pass `partner` / `partnerAddress` / `partnerFeeBps` raw — the server validates and encodes them. No client-side `getPartnerFee` round-trip.
+
+## Lifecycle
+
+<Steps>
+  <Step title="Price">
+    `GET /delta/v2/prices` — returns `route`, `alternatives`, and the `spender` contract address.
+  </Step>
+  <Step title="Approve">
+    ERC-20 `approve(spender, amount)` against `price.spender`, or sign Permit / Permit2 with the same `verifyingContract`. Native tokens skip this.
+  </Step>
+  <Step title="Build">
+    `POST /delta/v2/orders/build` — returns `{ toSign: { domain, types, value }, orderHash }`.
+  </Step>
+  <Step title="Sign">
+    Sign `toSign` with `signTypedData` on the user's wallet.
+  </Step>
+  <Step title="Submit">
+    `POST /delta/v2/orders` — passes `order: toSign.value` and `signature` to the relayer.
+  </Step>
+  <Step title="Poll">
+    `GET /delta/v2/orders/{orderId}` until `status === "COMPLETED"` (or a terminal failure).
+  </Step>
+</Steps>
+
+## Endpoints
+
+| Method | Path | Purpose |
+|---|---|---|
+| `GET` | `/delta/v2/prices` | Recommended route + alternatives, same-chain or crosschain |
+| `GET` | `/delta/v2/prices/bridge-routes` | Supported `(srcChainId, destChainId, tokens)` triples |
+| `GET` | `/delta/v2/prices/bridge-protocols` | Active bridge protocols (slug, name, icon) |
+| `GET` | `/delta/v2/prices/strategies/{chainId}` | Delta yield strategies with APR |
+| `GET` | `/delta/v2/prices/is-token-supported` | Quick token-support check |
+| `POST` | `/delta/v2/orders/build` | Server-built EIP-712 typed data ready to sign |
+| `POST` | `/delta/v2/orders` | Submit a signed order |
+| `POST` | `/delta/v2/orders/cancel` | Sign-and-post cancellation |
+| `GET` | `/delta/v2/orders` | List a user's orders (paginated) |
+| `GET` | `/delta/v2/orders/{orderId}` | Order by UUID |
+| `GET` | `/delta/v2/orders/hash/{hash}` | Order by EIP-712 hash |
+| `GET` | `/delta/v2/orders/fillablebalance/...` | Fillable balance for limit-order sizing |
+| `GET` | `/delta/v2/agents/list/{chainId}` | List active auction agents |
+
+## SDK shortcut
+
+Every endpoint is wrapped by [`sdk.deltaV2.*`](/sdk/modules/delta) — the SDK handles signing, partner-fee defaults, and the build → sign → post orchestration. For a 5-minute walkthrough see [SDK → Delta module](/sdk/modules/delta).
+
+## Related pages
+
+- [Why Delta](/delta/overview) — protocol overview.
+- [Order lifecycle and status codes](/delta/order-lifecycle-and-status-codes) — the V2 status model end-to-end.
+- [SDK → Delta module](/sdk/modules/delta) — TypeScript examples (V2 primary, V1 below).
+- [Delta V1 API](/api-reference/delta/overview) — the V1 surface, still fully supported.
diff --git a/api-reference/delta-v2/prices.mdx b/api-reference/delta-v2/prices.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/prices"
+description: "Recommended route plus alternatives for a same-chain or crosschain Delta V2 swap."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/prices"
+---
diff --git a/api-reference/delta-v2/strategies.mdx b/api-reference/delta-v2/strategies.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/v2/prices/strategies/{chainId}"
+description: "Delta yield strategies (with APR) wired for ProductiveOrder swaps, keyed by underlying token."
+openapi: "/api-reference/specs/delta-v2.json GET /delta/v2/prices/strategies/{chainId}"
+---
diff --git a/api-reference/delta/agents-list.mdx b/api-reference/delta/agents-list.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/agents/list/{chainId}"
+description: "List the active solver agents competing in the V1 auction for a chain."
+openapi: "/api-reference/specs/delta.json GET /delta/agents/list/{chainId}"
+---
diff --git a/api-reference/delta/bridge-info.mdx b/api-reference/delta/bridge-info.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/prices/bridge-info"
+description: "Supported crosschain bridge lanes grouped by srcChainId then destChainId."
+openapi: "/api-reference/specs/delta.json GET /delta/prices/bridge-info"
+---
diff --git a/api-reference/delta/bridge-protocols.mdx b/api-reference/delta/bridge-protocols.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/prices/bridge-protocols"
+description: "Active bridge protocols (slug, display name, icon)."
+openapi: "/api-reference/specs/delta.json GET /delta/prices/bridge-protocols"
+---
diff --git a/api-reference/delta/is-token-supported.mdx b/api-reference/delta/is-token-supported.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/prices/is-token-supported"
+description: "Quick yes/no check for Delta token support on a chain."
+openapi: "/api-reference/specs/delta.json GET /delta/prices/is-token-supported"
+---
diff --git a/api-reference/delta/orderbook.mdx b/api-reference/delta/orderbook.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/orders/orderbook/{chainId}/{agent}"
+description: "Pending orderbook slice for a specific auction agent. Agent operators only — not intended for end-user integrations."
+openapi: "/api-reference/specs/delta.json GET /delta/orders/orderbook/{chainId}/{agent}"
+---
diff --git a/api-reference/delta/orders-build.mdx b/api-reference/delta/orders-build.mdx
@@ -1,5 +1,5 @@
 ---
-title: "POST /delta/orders/build"
+title: "/delta/orders/build"
 description: "Build a signable Delta order — EIP-712 typed data — from a Delta quote."
 openapi: "/api-reference/specs/delta.json POST /delta/orders/build"
 ---

diff --git a/api-reference/delta/orders-cancel.mdx b/api-reference/delta/orders-cancel.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/orders/cancel"
+description: "Cancel one or more open Delta V1 orders by ID."
+openapi: "/api-reference/specs/delta.json POST /delta/orders/cancel"
+---
diff --git a/api-reference/delta/orders-fillable-balance.mdx b/api-reference/delta/orders-fillable-balance.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/orders/fillablebalance/{chainId}/{userAddress}"
+description: "User's source-token balance minus amounts committed to open limit orders. Use it when sizing a new limit order."
+openapi: "/api-reference/specs/delta.json GET /delta/orders/fillablebalance/{chainId}/{userAddress}/{tokenAddress}"
+---
diff --git a/api-reference/delta/orders-get-by-hash.mdx b/api-reference/delta/orders-get-by-hash.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/orders/hash/{hash}"
+description: "Fetch a Delta V1 order by its EIP-712 hash — useful before the order id is assigned."
+openapi: "/api-reference/specs/delta.json GET /delta/orders/hash/{hash}"
+---
diff --git a/api-reference/delta/orders-get-by-id.mdx b/api-reference/delta/orders-get-by-id.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/orders/{orderId}"
+description: "Fetch a Delta V1 order by its UUID — the id returned by POST /delta/orders."
+openapi: "/api-reference/specs/delta.json GET /delta/orders/{orderId}"
+---
diff --git a/api-reference/delta/orders-list.mdx b/api-reference/delta/orders-list.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/orders"
+description: "List a user's Delta V1 orders. Returns a flat array — V2 wraps the response in a paginated envelope."
+openapi: "/api-reference/specs/delta.json GET /delta/orders"
+---
diff --git a/api-reference/delta/orders.mdx b/api-reference/delta/orders.mdx
@@ -1,5 +1,5 @@
 ---
-title: "POST /delta/orders"
+title: "/delta/orders"
 description: "Submit a signed Delta order to the solver network."
 openapi: "/api-reference/specs/delta.json POST /delta/orders"
 ---
diff --git a/api-reference/delta/overview.mdx b/api-reference/delta/overview.mdx
@@ -1,13 +1,48 @@
 ---
-title: "Delta API"
-description: "OpenAPI reference for the Velora Delta intents API."
-keywords: ["delta","intents","api"]
+title: "Delta V1 API"
+sidebarTitle: "Overview"
+description: "Local EIP-712 order building, flat order lists, and the unified /quote endpoint with Market fallback. Shares on-chain contracts with Delta V2."
+keywords: ["delta", "delta v1", "api-reference"]
 ---
 
-<Note>This page is a stub. Content coming soon.</Note>
+Delta V1 is the original Delta protocol surface. The on-chain contracts and settlement model are identical to [Delta V2](/api-reference/delta-v2/overview); V1 differs in how clients assemble and consume orders:
 
-## Parameters
+- **Locally built orders.** Clients compose EIP-712 typed data themselves from a `/delta/prices` (or `/quote`) response. `POST /delta/orders/build` returns the `data` / `domain` / `types` triple to sign.
+- **Flat price.** `GET /delta/prices` returns a single `DeltaPrice` (or `BridgePrice` for crosschain) — no `route` / `alternatives` envelope.
+- **Flat order list.** `GET /delta/orders` returns a plain array, paginated by `page` / `limit` query params (no `total` / `hasMore` envelope).
+- **Locally resolved partner fee.** Clients call `GET /prices/partnerfee/{chainId}` themselves to look up the registered fee config (the V1 SDK caches it).
+- **Unified quote.** `GET /quote` returns either a `delta` block or a `market` block (or both with `mode=ALL`) — useful when you want Delta with automatic Market fallback. V2 doesn't have an equivalent endpoint.
 
-## Examples
+[Delta V2](/api-reference/delta-v2/overview) is recommended for new integrations. V1 remains fully supported.
+
+## Endpoints
+
+| Method | Path | Purpose |
+|---|---|---|
+| `GET` | `/quote` | Unified Delta-with-fallback-to-Market price |
+| `GET` | `/delta/prices` | Delta price (same-chain or crosschain) |
+| `GET` | `/delta/prices/bridge-info` | Supported crosschain lanes (srcChainId → destChainId → tokens) |
+| `GET` | `/delta/prices/bridge-protocols` | Active bridge protocols (slug, name, icon) |
+| `GET` | `/delta/prices/strategies/{chainId}` | Delta yield strategies with APR |
+| `GET` | `/delta/prices/is-token-supported` | Quick token-support check |
+| `GET` | `/prices/partnerfee/{chainId}` | Resolve registered partner-fee config (shared with Market) |
+| `POST` | `/delta/orders/build` | EIP-712 typed data ready to sign |
+| `POST` | `/delta/orders` | Submit a signed order |
+| `POST` | `/delta/orders/cancel` | Sign-and-post cancellation |
+| `GET` | `/delta/orders` | List a user's orders (flat array) |
+| `GET` | `/delta/orders/{orderId}` | Order by UUID |
+| `GET` | `/delta/orders/hash/{hash}` | Order by EIP-712 hash |
+| `GET` | `/delta/orders/fillablebalance/...` | Fillable balance for limit-order sizing |
+| `GET` | `/delta/orders/orderbook/{chainId}/{agent}` | Agent-facing orderbook slice (operators only) |
+| `GET` | `/delta/agents/list/{chainId}` | List active auction agents |
+
+## SDK shortcut
+
+The V1 surface is wrapped by [`sdk.delta.*`](/sdk/modules/delta#delta-v1) on the [Velora SDK](/sdk/overview). For a 5-minute walkthrough see [SDK → Delta module](/sdk/modules/delta).
 
 ## Related pages
+
+- [Why Delta](/delta/overview) — protocol overview.
+- [Order lifecycle and status codes](/delta/order-lifecycle-and-status-codes) — V1 status model end-to-end.
+- [Delta V2 API](/api-reference/delta-v2/overview) — the recommended surface.
+- [SDK → Delta module](/sdk/modules/delta) — TypeScript examples for both V1 and V2.
diff --git a/api-reference/delta/partner-fee.mdx b/api-reference/delta/partner-fee.mdx
@@ -0,0 +1,5 @@
+---
+title: "/prices/partnerfee/{chainId}"
+description: "Resolve the registered partner-fee config for a partner key. Shared between Market and Delta."
+openapi: "/api-reference/specs/delta.json GET /prices/partnerfee/{chainId}"
+---
diff --git a/api-reference/delta/prices.mdx b/api-reference/delta/prices.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/prices"
+description: "Delta V1 price for a same-chain or crosschain swap. Pass the response verbatim (with hmac) to /delta/orders/build."
+openapi: "/api-reference/specs/delta.json GET /delta/prices"
+---
diff --git a/api-reference/delta/quote.mdx b/api-reference/delta/quote.mdx
@@ -1,9 +1,10 @@
 ---
-title: "GET /quote (Delta)"
+title: "/quote"
 description: "Retrieve a Delta price, with optional fallback to Market via mode=ALL or mode=MARKET."
 openapi: "/api-reference/specs/delta.json GET /quote"
 ---
 
 <Note>
-  This endpoint accepts `mode=DELTA`, `mode=MARKET`, or `mode=ALL`. See [Trading modes](/integrate/trading-modes) for guidance and fallback semantics.
+  This endpoint accepts `mode=DELTA`, `mode=MARKET`, or `mode=ALL`. See [Trading
+  modes](/integrate/trading-modes) for guidance and fallback semantics.
 </Note>
diff --git a/api-reference/delta/strategies.mdx b/api-reference/delta/strategies.mdx
@@ -0,0 +1,5 @@
+---
+title: "/delta/prices/strategies/{chainId}"
+description: "Delta yield strategies with APR, keyed by underlying token. Used to source the strategy address for ProductiveOrder builds."
+openapi: "/api-reference/specs/delta.json GET /delta/prices/strategies/{chainId}"
+---
diff --git a/api-reference/market/prices.mdx b/api-reference/market/prices.mdx
@@ -1,9 +1,11 @@
 ---
-title: "GET /prices (Market)"
+title: "/prices"
 description: "Get a Market route from the Velora aggregator."
 openapi: "/api-reference/specs/market.json GET /prices"
 ---
 
 <Note>
-  Looking for a single endpoint that returns either a Market route or a Delta intent? Call [`GET /quote`](/api-reference/delta/quote) with `mode=ALL` — see [Trading modes](/integrate/trading-modes).
+  Looking for a single endpoint that returns either a Market route or a Delta
+  intent? Call [`GET /quote`](/api-reference/delta/quote) with `mode=ALL` — see
+  [Trading modes](/integrate/trading-modes).
 </Note>
diff --git a/api-reference/market/transactions.mdx b/api-reference/market/transactions.mdx
@@ -1,5 +1,5 @@
 ---
-title: "POST /transactions/:network (Market)"
+title: "/transactions/:network"
 description: "Build calldata for an Augustus v6.2 swap from a Market priceRoute."
 openapi: "/api-reference/specs/market.json POST /transactions/{network}"
 ---