Create a quotation

curl --request POST \ --url https://api.balampay.com/sandbox/v1/quotations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data ' { "amount": "1000.00", "recipient_id": "cccccccc-dddd-eeee-ffff-000000000000" } '

{ "amount": "1000.00", "currency": "USD", "fees": { "base_fees": { "bank_account_fee": "10.00", "bank_account_fee_percentage": "0.00", "fixed_fee": "0.00", "percentage_fee": "2.50", "total": "12.50" }, "client_markup": { "fixed_fee": "1.00", "percentage_fee": "0.00", "total": "1.00" }, "network_fee": "0.00", "total_fees": "13.50", "total": "13.50" }, "recipient_amount": "986.50", "recipient_currency": "USD", "quote_id": "dddddddd-eeee-ffff-0000-111111111111", "quote_expires_at": "2026-09-01T12:15:00.000Z" }

Authorizations

Authorization

string

header

required

The data.access_token value from Get access token.

x-api-key

string

header

required

API key issued by Kira.

Headers

X-Api-Version

string

Version applied to this request. It wins over your account's pinned version — see Versioning.

Example:

"2026-04-14"

Body

application/json

Send recipient_id or account_type — at least one is required.

amount

string

required

How much to price, as a positive decimal string with up to 8 decimals. With inverse_calculation this is what the recipient should end up with instead.

recipient_id

string<uuid>

A recipient you saved earlier. Its rail and details are used for the pricing.

account_type

enum<string>

Price a rail without saving a recipient first. Ignored when you also send recipient_id, which carries its own rail.

With WALLET and no recipient_id, wallet_network and wallet_token are required too.

Available options:

WIRE,

ACH,

WALLET

inverse_calculation

boolean

Work backwards: treat amount as what the recipient receives and return the amount you have to send. false when you omit it.

client_markup

object

Your own fees for this one quote, replacing whatever is configured on your account. fixed_fee and percentage_fee are both required once you send the object.

Show child attributes

wallet_network

enum<string>

Chain the recipient's wallet is on. Only used with account_type: WALLET and no recipient_id.

Available options:

solana,

polygon,

tron

wallet_token

enum<string>

Token the recipient receives. Not every token works on every chain, and a pair that does not is rejected with a 400.

Available options:

USDC,

USDT

payment_instructions

object

The token and chain you will deposit to fund the payout. Sending this makes the quote a crypto-funded one.

Show child attributes

Response

The quote was priced and saved.

The priced quote. Every amount is a decimal string.

amount

string

What you send.

currency

string

Currency of amount. Always USD.

fees

object

What comes off the amount before the recipient is paid.

Show child attributes

recipient_amount

string

What the recipient ends up with.

recipient_currency

string

Currency of recipient_amount — USD on a bank payout, USDC or USDT on a wallet payout.

payment_instructions

object

The funding token and chain, echoed back. Only on a crypto-funded quote.

quote_id

string<uuid>

Send this with a payout to settle at this price.

quote_expires_at

string

When the price stops holding, as an ISO 8601 timestamp.

Across the API

Authentication

Versioning

Users

Virtual Accounts

Recipients

Quotations

Payouts

Catalogs

Create a quotation

Authorizations

Headers

Body

Response