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

# /v1/quote

`POST /v1/quote`

## Request

- Base URL: `https://cs-api.sandbox.paybis.com`
- URL: `https://cs-api.sandbox.paybis.com/v1/quote`
- Auth: API key in header `Authorization` and API key in header `x-request-signature`

Creates a quote for a crypto payout and returns its price and expiration time.

## 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: Paybis service fee. Includes the partner fee, which is listed separately under `breakdown` for information only. Do not add `breakdown` amounts on top of this value.
        - `amount` string, required
        - `currency` string, required
        - `breakdown` object, required: Parts already included in the service fee amount.
          - `partner_fee` object, required: Partner fee in fiat currency. Always present; `0.00` when the partner has no commission configured.
            - `amount` string, required
            - `currency` string, required
      - `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
    - `fiat_equivalent` object, nullable: Fiat equivalent taken from Processing `amountFromEquivalent`. Null when not available.
      - `amount` string, required: Fiat equivalent amount.
      - `currency` string, required: Currency code of the fiat equivalent amount.

## Other responses

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

---

[API](https://skmtc.dev/payb/apis/paybis-send.md) - [All operations](https://skmtc.dev/payb/apis/paybis-send/llms.txt) - [OpenAPI document](https://skmtc.dev/payb/apis/paybis-send/revisions/5327e9b2ad8d?raw)