✏️Parameters

With these parameters, you can control what your users see when they open your integration

Note: Query params are case sensitive

FieldValuesTypeDefault Value

apiKey - Required Kado integrator key. This is a public key used for identifier purposes.

[UUID] Ex: fa47115e-35e3-11ed-a261-0242ac120002

String

onPayCurrency

The fiat currency that will be selected by default for the user to pay in. Users can select any other that is available for selection.

USD, EUR, CAD, GBP, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD

String

USD

onRevCurrency The cryptocurrency that will be selected by default for the user to buy. Users can select any other that is available for selection. Note: requires network to be set.

USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK

String

offPayCurrency

The cryptocurrency that will be selected by default for the user to sell. Users can select any other that is available for selection. Note: Off Ramp currently not available for Arbitrum, Optimism, Polygon

USDT, USDC, SOL, ETH, AVAX, ATOM, BTC, XLM, XRP, LTC, NTRN, SEI, TIA, BONK, JUP, KUJI, QCK

String

offRevCurrency

The fiat currency that will be selected by default for the user to be paid in. Users can select any other that is available for selection.

USD

String

product

The option that will be selected by default (on-ramp or off-ramp). Users can change the selection.

BUY, SELL, SWAP

String

onPayAmount

The amount that will be selected by default for the user to buy. Users can enter any other amount.

Any positive number, rounded to the nearest cent. Min/max will be validated upon widget load. Min >= 10

String

offPayAmount

The amount that will be entered by default for the user to sell. Users can enter any other amount.

Any positive number. Min/max will be validated upon widget load.

String

onToAddress

Blockchain address of the wallet where the purchased

cryptocurrency will be sent to.

Valid wallet address matching the network Ex: 0x3ACfa4b5320550199C322A9B33e85c70d0F90D1b

String

onToAddressMulti Key-value pairs to set multiple wallet addresses, associated to a specific blockchain.

Valid chain:address key-value pairs Ex: ETHEREUM:0x1234,OSMOSIS:osmo1234,COSMOS HUB:cosmos1234

Array[string]

offFromAddress Blockchain address of the wallet that cryptocurrency will be sent from, for an off-ramp.

Valid wallet address matching the network Ex: 0x3ACfa4b5320550199C322A9B33e85c70d0F90D1b

String

network

The crypto network that will be selected by default for buy or sell. Users can select any other networks that are available for selection.

Note: Requires onRevCurrency to be set. Note: Off Ramp currently not available for Arbitrum, Optimism, Polygon

BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER

String

cryptoList

A comma-separated list of crypto currencies that users can buy or sell. Only these will show on the widget.

USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK

Array[string]

USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK

fiatList

A comma-separated list of fiat currencies that users can buy or sell. Only these will show on the widget.

USD, CAD, GBP, EUR, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD

Array[string]

USD, CAD, GBP, EUR, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD

networkList

A comma-separated list of crypto networks that users can buy or sell. Only these will show on the widget. Note: Requires onRevCurrency to be set.

BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER

Array[string]

BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER

productList A comma-separated list of products that the user will see on the widget.

BUY, SELL, SWAP

Array[string]

BUY, SELL, SWAP

theme Sets the theme of the widget to light or dark. The default theme is light.

light, dark

String

light

email The user's email that you'd like to trigger a login for

valid email address

String

mode The UI mode. Minimal mode will remove the menu and drop users directly into the Order Confirmation page.

minimal, full

String

fiatMethodList The fiat payment methods to allow the user to pay with, or sell to.

card, ach, apple, wire, sepa, debit_only

Array[string]

card, ach, apple, wire, sepa, debit_only

userRef An optional reference provided by the integrator to link a reference in the integrator's system to a Kado user.

valid uuid

String

sessionId An optional reference provided by the integrator to link a session to any orders created within that session. The sessionId will correspond to the orderRef field for a given order obtained via the API/webhooks.

valid uuid

String

phone The user's phone number that you'd like to verify.

valid phone number

String

primaryColor The primary display color for your widget theme.

valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900

String

secondaryColor The secondary display color for your widget theme.

valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900

String

successColor The color to display upon successful interactions.

valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900

String

warningColor The color to display upon warnings for user interactions.

valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900

String

errorColor The color to display upon errored interactions.

valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900

String

Last updated