Quote a fiat purchase
Prices a fiat purchase — how much crypto a given amount of currency buys, including the onramp fee.
The onramp fee is set by the provider, not by Hypermid, and is reported back on the completed order.
Authorizations
Soft-auth read routes accept x-api-key with a publishable or partner key; money-moving routes require a secret partner key in Authorization: Bearer.
Body
Fiat currency code (ISO 4217).
"USD"
Destination crypto asset symbol.
"USDC"
Destination chain code, as used by the fiat provider. Read the supported set from the onramp config endpoint rather than assuming it matches a chain id.
"base"
Fiat amount to spend (decimal string). Omit for a reverse quote — supply dstAmount instead and the provider computes this.
"100"
Destination crypto amount to receive (decimal string). When set, this is a REVERSE quote: the provider computes the srcAmount (fiat) needed to deliver it, and srcAmount must be omitted. Used by fixed-price checkouts.
"5"
Payment method code. Defaults to card.
"card"
Payer wallet address (defaults to a sentinel when unconnected).
ISO 3166-1 alpha-2 user country. Defaults to US.
"US"