Pricing Profiles (/api/v1/auth/pricing/profiles)
A pricing Profile describes how you charge (fees, spread behavior, settlement side) for a flow:
flow_type | Use case |
|---|---|
onramp | Fiat → crypto (e.g. customer buys USDT) |
offramp | Crypto → fiat (e.g. customer sells USDT) |
p2p | Internal P2P USDT transfers with optional fiat reference |
b2b | Vendor-to-vendor B2B transfers |
b2b2c | Extended B2B2C flows (where configured) |
asset (typically USDT), optional network (tron or ethereum) and fiat_currency when the profile is scoped to a corridor. fee_type is one of none, fixed, percentage, or hybrid, with BPS and min/max as needed.
Note: Creating and updating pricing profiles is admin-only (POST,GET,PUT, active flag endpoints).
FX Rate Quotes (/api/v1/auth/pricing/fx-quotes)
An FX Quote stores reference_rate and applied_rate (or derives applied rate from spread_bps) for a given flow, asset, and fiat_currency. Use expires_at so stale quotes fail validation when building snapshots.
List and fetch by ID for audit; use GET .../fx-quotes/active when you need the current active quote for a flow/asset/fiat (+ optional network).
Live Quote Tool (POST /api/v1/auth/pricing/quote)
Combines the active pricing profile and active FX for a hypothetical amount (amount_in + amount_in_type of fiat or crypto) — useful for admin dashboards and sanity checks before placing orders.
Linking to Orders and Transfers
When creatingPOST /api/v1/auth/orders or transfer endpoints, you pass:
pricing_profile_idfx_rate_quote_id
400 — either supply all commercial fields required by the endpoint or omit pricing entirely where allowed.
See also Orders and payments and Transfers (P2P and B2B).