Resolve Active Pricing IDs + Commercial Preview (Authenticated)

curl --request POST \
  --url https://crypto.westminister.tech/api/v1/auth/pricing/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": "USDT",
  "fiat_currency": "KES",
  "amount_in": "<string>",
  "network": "<string>",
  "source_country": "<string>",
  "destination_country": "<string>",
  "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "offer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

{
  "pricing_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fx_rate_quote_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "flow_type": "<string>",
  "network": "<string>",
  "asset": "<string>",
  "fiat_currency": "<string>",
  "source_country": "<string>",
  "destination_country": "<string>",
  "amount_in": "<string>",
  "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "offer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "order_type": "<string>",
  "reference_fx_rate": "<string>",
  "applied_fx_rate": "<string>",
  "spread_bps": 123,
  "spread_amount": "<string>",
  "fees": {
    "fixed_fee": "<string>",
    "fixed_fee_currency": "<string>",
    "percentage_fee_bps": 123,
    "percentage_fee_amount": "<string>",
    "total_fee_amount": "<string>",
    "fee_currency": "<string>"
  },
  "amounts": {
    "gross_fiat_amount": "<string>",
    "net_fiat_amount": "<string>",
    "gross_crypto_amount": "<string>",
    "net_crypto_amount": "<string>"
  },
  "settlement_side": "<string>",
  "rate_source": "<string>",
  "quoted_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z"
}

Pricing

Resolve Active Pricing IDs + Commercial Preview (Authenticated)

Resolves the active pricing_profile_id and fx_rate_quote_id for the provided flow context, then returns a computed commercial preview. Intended for app clients before order creation.

Liquidity context (optional vendor_id + offer_id): In the API these fields are still named vendor_id and offer_id for historical reasons. Conceptually they mean:

vendor_id — liquidity provider: the user account that published the marketplace line.
offer_id — liquidity listing: the specific published terms (asset, fiat pair, limits, status) your order will attach to for validation and lifecycle. It is not “where the customer gets USDT”: for off-ramp the customer already holds crypto in custody. The listing is the conversion/routing anchor, not the funding source of their balance.

When both IDs are sent, the liquidity listing must exist, belong to that liquidity provider, be active, and its asset must match the request asset. Omit both for flows that do not use a listing (e.g. some p2p/b2b previews).

OTC bank deposits (B2B): Use POST /pricing/resolve-otc with otc_type: deposit so pricing rows scoped with otc_type do not collide with generic b2b resolve.

POST

api

auth

pricing

resolve

Resolve Active Pricing IDs + Commercial Preview (Authenticated)

curl --request POST \
  --url https://crypto.westminister.tech/api/v1/auth/pricing/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": "USDT",
  "fiat_currency": "KES",
  "amount_in": "<string>",
  "network": "<string>",
  "source_country": "<string>",
  "destination_country": "<string>",
  "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "offer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

{
  "pricing_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fx_rate_quote_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "flow_type": "<string>",
  "network": "<string>",
  "asset": "<string>",
  "fiat_currency": "<string>",
  "source_country": "<string>",
  "destination_country": "<string>",
  "amount_in": "<string>",
  "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "offer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "order_type": "<string>",
  "reference_fx_rate": "<string>",
  "applied_fx_rate": "<string>",
  "spread_bps": 123,
  "spread_amount": "<string>",
  "fees": {
    "fixed_fee": "<string>",
    "fixed_fee_currency": "<string>",
    "percentage_fee_bps": 123,
    "percentage_fee_amount": "<string>",
    "total_fee_amount": "<string>",
    "fee_currency": "<string>"
  },
  "amounts": {
    "gross_fiat_amount": "<string>",
    "net_fiat_amount": "<string>",
    "gross_crypto_amount": "<string>",
    "net_crypto_amount": "<string>"
  },
  "settlement_side": "<string>",
  "rate_source": "<string>",
  "quoted_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

flow_type

enum<string>

required

Available options:

onramp,

offramp,

p2p,

b2b,

b2b2c,

remittance

asset

string

required

Example:

"USDT"

fiat_currency

string

required

Example:

"KES"

amount_in

string

required

Positive decimal string

amount_in_type

enum<string>

required

Available options:

fiat,

crypto

network

string

tron or ethereum

source_country

string

Required when flow_type=remittance. Prefer active ISO 3166-1 alpha-3 code from the countries catalog. Example KEN. Legacy alpha-2 input is accepted and normalized to alpha-3

destination_country

string

Required when flow_type=remittance. Prefer active ISO 3166-1 alpha-3 code from the countries catalog. Example UGA. Legacy alpha-2 input is accepted and normalized to alpha-3

vendor_id

string<uuid>

Liquidity provider (publisher of the marketplace line). API name retained as vendor_id.

offer_id

string<uuid>

Liquidity listing id — published USDT/fiat terms the preview should align with. API name retained as offer_id.

order_type

enum<string>

Available options:

ON_RAMP_BUY,

OFF_RAMP_SELL,

ON_RAMP_SELL,

OFF_RAMP_BUY

Response

Resolved IDs and pricing preview

pricing_profile_id

string<uuid>

fx_rate_quote_id

string<uuid>

flow_type

string

network

string

asset

string

fiat_currency

string

source_country

string

Resolved ISO 3166-1 alpha-3 source country code

destination_country

string

Resolved ISO 3166-1 alpha-3 destination country code

amount_in

string

amount_in_type

enum<string>

Available options:

fiat,

crypto

vendor_id

string<uuid>

offer_id

string<uuid>

order_type

string

reference_fx_rate

string

applied_fx_rate

string

spread_bps

integer

spread_amount

string

fees

object

Show child attributes

amounts

object

Show child attributes

settlement_side

string

rate_source

string

quoted_at

string<date-time>

expires_at

string<date-time> | null

Compute Quote From Active Profile + FX (Admin)Resolve OTC Pricing (B2B Deposit Or Withdrawal Lane)