Reference page

Quote Endpoint

Request a protection quote and receive locked terms plus evidence metadata.

Route

POST /v1/quotes

This is the entry point for a protection request. The request body is intentionally small:

{
  "partner_id": "partner_1",
  "asset": "BTC",
  "amount": "0.5",
  "direction": "Long",
  "duration_seconds": 3600
}

Contract

The quote contract is designed around four guarantees:

  1. the partner sends one asset, amount, direction, and protection window,
  2. Slice returns a locked premium and expiry,
  3. the quote can be accepted later by reference,
  4. evidence is available for finance and review without exposing private pricing mechanics.

Response Excerpt

The route can return additional partner-safe fields. The excerpt below uses the wire fields a wallet needs for the customer decision:

{
  "quote_id": "returned_quote_reference",
  "partner_id": "partner_1",
  "asset": "BTC",
  "amount": "0.5",
  "direction": "Long",
  "duration_seconds": 3600,
  "premium_usd": "9.5",
  "expires_at": "2026-03-27T08:05:00Z",
  "created_at": "2026-03-27T08:00:00Z"
}

Next step

Use the returned quote_id when creating a protected transaction via the transaction endpoint.