Skip to content
Kaito Core API/
/
Create FX quote

Kaito Core API (2.0.0)

Core payment operations: Quotes, Payments, Payouts, and FX.

Rail Types: CRYPTO_CRYPTO (on-chain), FIAT_CRYPTO (on-ramp), CRYPTO_FIAT (off-ramp), FIAT_FIAT (cross-border).

Typical Flow: Get rates -> Create quote -> Execute payment/payout -> Track status.

Destination Types (Payments): handle, phone, address.

Beneficiary Types (Payouts): bank_account, cash_pickup, mobile_money.

Download OpenAPI description
core.json
core.yaml
Overview
URL
https://developer.kai2.io/support
Kaito Developer Support
support@kai2.io
License
Apache 2.0
Terms of Service
Languages
Servers
Mock server
https://developer.kaito.io/_mock/core/
Production
https://api.kai2.io/
Sandbox
https://sandbox.api.kai2.io/

Quotes

Lock pricing and routing

Operations

Execution Plans

Multi-step routing plans

Operations

Payments

Execute payments (CRYPTO_CRYPTO, FIAT_CRYPTO)

Operations

Payouts

Execute payouts/off-ramp (CRYPTO_FIAT, FIAT_FIAT)

Operations

FX Rates

Indicative exchange rates

Operations

FX Quotes

Firm FX quotes

Operations

Create FX quote

Request

Creates a firm FX quote locked for a short time window.

Security
oAuth2
Headers
Idempotency-Keystring

A unique key to make POST requests idempotent.

Bodyapplication/jsonrequired
baseCurrencystringrequired
Example: "USD"
quoteCurrencystringrequired
Example: "GTQ"
amountnumberrequired
Example: 1000
sidestringrequired
Enum"buy""sell"
lockDurationinteger or null
Example: 60
curl -i -X POST \
  https://developer.kaito.io/_mock/core/v1/fx-quotes \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: string' \
  -d '{
    "baseCurrency": "USD",
    "quoteCurrency": "GTQ",
    "amount": 1000,
    "side": "buy",
    "lockDuration": 60
  }'

Responses

FX Quote created

Bodyapplication/json
quoteIdstringrequired
Example: "fxq_01JH..."
baseCurrencystringrequired
quoteCurrencystringrequired
amountnumberrequired
sidestringrequired
Enum"buy""sell"
ratestringrequired
Example: "7.7310"
convertedAmountnumberrequired
Example: 7731
feesArray of objects
expiresAtstring(date-time)required
createdAtstring(date-time)required
Response
application/json
{
  "quoteId": "fxq_01JH...",
  "baseCurrency": "string",
  "quoteCurrency": "string",
  "amount": 0,
  "side": "buy",
  "rate": "7.7310",
  "convertedAmount": 7731,
  "fees": [
    { … }
  ],
  "expiresAt": "2019-08-24T14:15:22Z",
  "createdAt": "2019-08-24T14:15:22Z"
}

Get FX quote by ID

Request

Security
oAuth2
Path
quoteIdstringrequired
curl -i -X GET \
  'https://developer.kaito.io/_mock/core/v1/fx-quotes/{quoteId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

FX Quote details

Bodyapplication/json
quoteIdstringrequired
Example: "fxq_01JH..."
baseCurrencystringrequired
quoteCurrencystringrequired
amountnumberrequired
sidestringrequired
Enum"buy""sell"
ratestringrequired
Example: "7.7310"
convertedAmountnumberrequired
Example: 7731
feesArray of objects
expiresAtstring(date-time)required
createdAtstring(date-time)required
Response
application/json
{
  "quoteId": "fxq_01JH...",
  "baseCurrency": "string",
  "quoteCurrency": "string",
  "amount": 0,
  "side": "buy",
  "rate": "7.7310",
  "convertedAmount": 7731,
  "fees": [
    { … }
  ],
  "expiresAt": "2019-08-24T14:15:22Z",
  "createdAt": "2019-08-24T14:15:22Z"
}

Corridors

Supported corridors

Operations