Request an FX quote

Optional (on request). Applies only if this feature is enabled for your client.

Prices a conversion for the caller. payment_type defaults to FX_SEND_1 (convert and pay out to a beneficiary from the holder's KOBBLE_FX_1 wallet in sell_asset). With FX_TRANSFER_4 the quote is for a conversion between two of one holder's own KOBBLE_<CCY>_4 wallets, named by from_wallet_id and to_wallet_id; the response echoes payment_type, from_wallet_id and to_wallet_id, and the quote can only be spent on that pair via POST /customers/v1/transactions with payment_type: FX_TRANSFER_4.

The quote is returned PENDING and priced asynchronously: poll GET /customers/v1/fx-quotes/{id} until status is QUOTED, then cite its id as quote_id. The returned rate has Kobble's spread embedded. expires_at on an FX_TRANSFER_4 quote is a Kobble staleness window (60 seconds by default), not a partner rate lock: the partner re-prices at execution and a conversion whose wholesale rate has drifted beyond tolerance is declined with reason_code FX_RATE_TOLERANCE_EXCEEDED. FX_TRANSFER_4 quotes are issued even while execution of that rail is switched off, so a rate table is available ahead of launch; the transaction is what is refused (FX_TRANSFER_4 execution is not enabled). An FX_TRANSFER_4 quote also needs a spread configured for your client on the corridor (400 FX_TRANSFER_4 requires a configured markup for this owner and corridor otherwise — contact Kobble).

Requires the client/write scope. Owner-scoped. Not idempotent: each call creates a new quote.

Request

Header Params

Body Params application/json

Examples

FX_SEND_1 — sell 1,000 AUD for EUR from the holder's AUD FX walletFX_TRANSFER_4 — convert 100 AED from the holder's AED wallet into its EUR wallet

{
    "holder_id": "6f1c2a4e-3b7d-4e0a-9c2f-1d5e8a7b6c3d",
    "sell_asset": "AUD",
    "buy_asset": "EUR",
    "fixed_side": "SELL",
    "fixed_amount": 1000
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Created

application/json

Quote created (PENDING). Poll GET /customers/v1/fx-quotes/{id} for the price.

Bodyapplication/json

Example

{
    "id": "b4d6f8a0-5c21-4e73-9d18-3a6b2c5e7f94",
    "owner": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "holder_id": "6f1c2a4e-3b7d-4e0a-9c2f-1d5e8a7b6c3d",
    "partner_product": "KOBBLE_AED_4",
    "payment_type": "FX_TRANSFER_4",
    "sell_asset": "AED",
    "buy_asset": "EUR",
    "from_wallet_id": "3e0c2a1d-9b47-4c86-9a35-5f1e8d7c2b40",
    "to_wallet_id": "7a5b1c8e-2d34-4f90-8b61-0c9e4a3d7f52",
    "fixed_side": "SELL",
    "fixed_amount": "100",
    "derived_amount": null,
    "rate": null,
    "status": "PENDING",
    "expires_at": null,
    "external_id": null,
    "reason": null,
    "reason_code": null,
    "created_at": "2026-09-29T02:10:11.000Z",
    "updated_at": "2026-09-29T02:10:11.000Z"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error