---
title: "Quote endpoint"
method: POST
path: "/v1/quote"
tags: ["Quote"]
---

# Quote endpoint

`POST /v1/quote`

## Headers

- `Authorization` string, required
- `X-Request-Signature` string, required

## Request body

- QuoteRequestPublicV1
  - `quote_id` string, uuid, required — Partner-generated identifier of a specific quote in UUID format.
  - `crypto_currency` string, required — Crypto asset code.
  - `fiat_currency` string, required — Fiat currency code.
  - `requested_currency` string, required — Base crypto or fiat currency for quote calculation, see request examples.
  - `requested_amount` string, required — Requested amount with precision 2 for fiat and 8 for crypto.
  - `requested_amount_type` string, nullable, required — Allowed values are: from / to
  - `direction` 'buy' | 'sell' — Quote direction. Allowed values are: buy / sell.

## Response `200`

OK

- QuoteResponseV1
  - `status` string, required
  - `result` object, required
    - `quote_id` string, required — Identifies a specific quote.
    - `digital_money` object, required
      - `amount` string, required — Digital currency amount.
      - `currency` string, required — Digital currency code.
    - `fiat_money` object, required
      - `amount` string, required — Fiat currency amount.
      - `currency` string, required — Fiat currency code.
    - `time` string, date-time, required — Quote creation timestamp.
    - `expiration` string, date-time, required — Quote expiration timestamp.
    - `fees` object, required
      - `network_fee` object
        - `amount` string
        - `currency` string
      - `service_fee` object
        - `amount` string
        - `currency` string
      - `total_fee` object
        - `amount` string
        - `currency` string
      - `fee_discount` object, nullable
        - `amount` string
        - `currency` string
    - `exchange_rate_fiat_to_crypto` ExchangeRateV1 — Exchange rate for single currency pair
      - `from` string, required — currency code or assetId
      - `to` string, required — currency code or assetId
      - `rate` string, required
    - `exchange_rate_crypto_to_fiat` ExchangeRateV1 — Exchange rate for single currency pair
      - `from` string, required — currency code or assetId
      - `to` string, required — currency code or assetId
      - `rate` string, required

## Other responses

- `400` — Bad request
- `404` — Not found
- `422` — Unprocessable entity

---

[API](https://skmtc.dev/payb/apis/widget.md) · [All operations](https://skmtc.dev/payb/apis/widget/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payb/widget/revisions/2c2cf39656c5/schema)