GlobbaPayDocs

API reference

FX

Quote, lock, convert — with the disclosure recorded.

POST/v1/fx/quotes

Proposed design

Request → 201

{ "from": "USD", "to": "NGN", "sell_minor": 100000 }

{
  "id": "fxq_2m91k",
  "rate": 1531.0,
  "buy_minor": 152334500,
  "fee_minor": 500,
  "expires_at": "2026-07-23T10:24:30Z"   // 30-second lock
}

POST/v1/fx/conversions

Request → 201

{ "quote": "fxq_2m91k" }

{
  "id": "cnv_88data",
  "rate": 1531.0,
  "executed_at": "2026-07-23T10:24:11Z"
}

Executing an expired quote fails withquote_expired — request a fresh one. Every conversion keeps its applied rate, fee, and timestamps as a disclosure record.