v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB

Kraken Embed

Request Quote

Request a price quote for an asset that may be used to execute a trade later on. The quote will be valid for a limited time as specified in the response.

post/v1/kraken_embed/quotes

Headers

privy-app-idstring required

ID of your Privy app.

Request body

fee_bpsstring required

quote_currencystring nullable

spread_bpsstring required

type'receive' | 'spend' required

Whether the quote amount refers to the asset being received or spent.

user_idstring required

Example request

{
  "amount": {
    "amount": "100.00",
    "asset": "USD",
    "asset_class": "currency"
  },
  "fee_bps": "100",
  "quote": {
    "asset": "BTC"
  },
  "spread_bps": "50",
  "type": "spend",
  "user_id": "did:privy:clabcd1234"
}

Response

Quote request successful. Returns quote details including pricing and expiration.

Example response

{
  "data": {
    "result": {
      "expires": "2024-04-15T12:30:00Z",
      "quote_id": "QTE-12345-ABCDE",
      "quoted_receive": null,
      "quoted_spend": null,
      "quoted_unit_price": null,
      "receive": {
        "asset": "BTC",
        "asset_class": "currency",
        "fee": "0.00000150",
        "subtotal": "0.00149850",
        "total": "0.00150000"
      },
      "spend": {
        "asset": "USD",
        "asset_class": "currency",
        "fee": "1.00",
        "subtotal": "99.00",
        "total": "100.00"
      },
      "status": "new",
      "type": "spend",
      "unit_price": {
        "asset": "BTC",
        "asset_class": "currency",
        "denomination_asset": "USD",
        "denomination_asset_class": "currency",
        "unit_price": "66000.00"
      }
    }
  }
}