Skip to main content
PIK’s Rates method converts a balance from one currency to another at the prevailing live market rate at the moment you submit the request. There is no quoting step. You call the convert endpoint and the conversion executes immediately.

​
How Rates works

Step 1 (optional) — Retrieve the current indicative rate. Call GET /api/v1/fx/rates with sell_currency, buy_currency, and amount. This is for display or estimation only — it does not lock a price. Step 2 — Submit the conversion. Call POST /api/v1/fx/conversions with sell_currency, buy_currency, amount, and conversion_type set to rate. PIK executes immediately at the live rate and credits the bought currency to your wallet.

​
Request fields

  • sell_currency — Currency converting from, for example USDT.
  • buy_currency — Currency converting to, for example AUD.
  • sell_amount or buy_amount — Specify how much to sell or how much to receive. PIK calculates the other side.
  • conversion_type — Set to rate.
  • x-on-behalf-of header — Connected account ID if converting on behalf of a customer.

​
Things to know

No rate lock — The rate is determined at execution. If you wait between retrieving an indicative rate and submitting, the actual rate may differ. Sufficient balance required — PIK rejects the conversion if the sell currency balance is insufficient. Minimum amounts apply — Requests below the minimum return a 422 error.