---
title: "Request payment quote"
method: POST
path: "/payments/rfq"
tags: ["Payments"]
---

# Request payment quote

`POST /payments/rfq`

Retrieves a quote for a payout. Exactly one of `quantity` or `total` must be supplied. The returned `quote_id` can be passed to `POST /payments/execute` before `expire_ts`.

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- PostPaymentsRequestForQuoteRequest
  - `participant_code` string, required — The participant that the quote is being generated for. Typically the end customer.
  - `quoted_currency` 'CAD' | 'EUR' | 'GBP' | 'JPY' | 'MXN' | 'USD', required — the quoted asset
  - `underlying_currency` 'AAVE.ETH' | 'ADA' | 'ALGO' | 'AVAX' | 'BAT.ETH' | 'BCH' | 'BTC' | 'BUSD.ETH' | 'COMP.ETH' | 'DAI.ETH' | 'DOGE' | 'DOT' | 'EGLD' | 'EOS' | 'ETC' | 'ETH' | 'ETH.ARBITRUM' | 'GRT.ETH' | 'GYEN.ETH' | 'HBAR' | 'LINK.ETH' | 'LTC' | 'LUNA' | 'MATIC.ETH' | 'MATIC.POLYGON' | 'MKR.ETH' | 'MOB' | 'SAND.ETH' | 'SOL' | 'UNI.ETH' | 'USDC.ETH' | 'USDC.ALGO' | 'USDC.POLYGON' | 'USDC.SOL' | 'USDC.HBAR' | 'USDC.XLM' | 'USDC.AVAX' | 'USDT.ETH' | 'UST' | 'WBTC.ETH' | 'XEM' | 'XLM' | 'XRP' | 'XTZ' | 'ZUSD.ETH', required — the underlying asset
  - `side` 'buy' | 'sell', required — The participant side of the quote - `buy` or `sell`.
  - `total` string — The desired amount expressed in the `quoted_currency`. Exactly one of `quantity` or `total` must be provided.
  - `quantity` string — The desired amount expressed in the `underlying_currency`. Exactly one of `quantity` or `total` must be provided.
  - `quote_expiry` '5s' | '30s' | '1m' | '5m' | '10m' | '15m' — Requested time-to-live for the quote. Defaults to `5s` when omitted.

## Response `200`

Quote generated. Execute the quote via `POST /payments/execute` before `expire_ts` elapses.

- PostPaymentsRequestForQuoteResponse
  - `message` object
    - `request_id` string, uuid — Request identifier echoed back from the request.
    - `participant_code` string — Platform participant code that owns the quote.
    - `underlying_currency` string — The asset that is being bought or sold.
    - `quoted_currency` string — The currency that the `underlying_currency` is priced in.
    - `side` 'buy' | 'sell' — Participant side of the quote.
    - `quantity` string — Amount expressed in the `underlying_currency`.
    - `price` string — Unit price of the `underlying_currency` expressed in the `quoted_currency`.
    - `quote_id` string, uuid — Identifier of the quote. Pass to `POST /payments/execute` to execute.
    - `expire_ts` number — Quote expiration as a Unix timestamp in milliseconds.
    - `account_group` string — Account group that will be the counterparty to the trade (typically the zerohash account group).
    - `account_label` string — Account label on the counterparty side.
    - `obo_participant` OBOParticipantEntity
      - `participant_code` string — The identifier of the participant making the request
      - `account_group` string — The identifier of the the account group
      - `account_label` string — The account label associated with the account
    - `quote_notional` string — Notional value of the quote in the `quoted_currency` (price × quantity), pre-spread.
    - `disclosed_spread` string — Absolute spread applied to the quote, in `quoted_currency` units.
    - `disclosed_spread_rate` string — Spread rate applied to the quote, in basis points (1 bps = 0.01%).

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)