---
title: "Widget Quote"
method: POST
path: "/widget/quote"
---

# Widget Quote

`POST /widget/quote`

Gets a quote for a widget transaction

## Request body

- object
  - `currency` string — Local currency user is buying tokens with
  - `localAmount` integer — Total amount of local currency user is wanting to buy of tokens. This should only be used for BUY transactionType
  - `cryptoAmount` number, float — Total amount of crypto currency user is wanting to sell of tokens. This should only be used for SELL transactionType
  - `coin` string — The type of coin/token that the user is wanting to buy
  - `network` string — The network of the coin/token that the user is wanting to buy
  - `channelId` string — The channelId of the payment method that the user is wanting to use. This will be retrieved from the getChannels API
  - `transactionType` string — Type of the transaction wanting to be conducted by the user. This will be 'Buy' or 'Sell'

## Response `200`

200

- object
  - `currency` string
  - `coin` string
  - `cryptoAmount` integer
  - `network` string
  - `channelId` string
  - `transactionType` string
  - `fiatReceived` number
  - `convertedAmount` integer
  - `rateLocal` number
  - `serviceFeeLocal` number
  - `serviceFeeUSD` integer
  - `partnerFeeLocal` number
  - `partnerFeeUSD` integer
  - `paymentMethod` string
  - `settlement` string
  - `updatedAt` string
  - `expireAt` string
  - `transactionLimitMin` integer
  - `transactionLimitMax` integer
  - `cryptoMaxLimit` number
  - `cryptoMinLimit` number

## Other responses

- `400` — 400

---

[API](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api.md) · [All operations](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yellowcard/yellow-cards-payment-api/versions/516d251059cc/schema)