📝
Integrate Kado
  • Kado Documentation
  • Kado Products
    • ⬆️Kado On-Ramp
    • ⬇️Kado Off-Ramp
  • Integrations
    • 🧰Integrate Kado
      • ⚒️The Widget
        • 🖼️iframe Embed (Recommended)
        • 🔗New Window/Tab
        • 🔭Widget + React Demo
        • 📱Widget + Mobile Demo
      • ⚒️The Hybrid API
        • Get Quote
        • Pay via Kado Widget
        • Get Order Status
        • Advanced
      • ⚒️Sandbox
    • ✏️Customizing Your Integration
      • ✏️Parameters
      • ✏️Mobile ACH Linking
      • ✏️Integrate Stellar SEP-24 Anchor
    • 👍Best Practices
    • 🔢Data & Analytics
  • References
    • 🚀Upcoming Features
    • ❓FAQs and Coverage
Powered by GitBook
On this page
  • Get blockchains
  • Get assets
  • Get configs
  • Get quote

Was this helpful?

  1. Integrations
  2. Integrate Kado
  3. The Hybrid API

Get Quote

Get Assets/Networks + Quotes

PreviousThe Hybrid APINextPay via Kado Widget

Last updated 3 months ago

Was this helpful?

The first piece of the integration requires you to build a custom frontend that has the necessary list of assets you want your customers to be able to buy or sell.

For example, you may want to only display USDC, USDT, and ETH assets, and want to build your custom frontend around that. To do so, check the list of available assets. You'll need the Asset symbol from the /v1/ramp/supported-assets endpoint, and the Blockchain origin from the /v1/ramp/blockchains endpoint to get quotes for the assets you enable customers to buy/sell.

Get blockchains

GET https://api.kado.money/v1/ramp/blockchains

The list of active blockchains available on Kado.

GET 200 https://api.kado.money/v1/ramp/blockchains

{
  success: boolean,
  message: string,
  data: {
    blockchains: [
      {
        _id: string,
        supportedEnvironment: string,
        network: string,
        origin: string,
        label: string,
        associatedAssets: {
            _id: string,
            name: string,
            description: string,
            label: string,
            supportedProviders: string[],
            stablecoin: boolean,
            liveOnRamp: boolean,
            createdAt: string,
            updatedAt: string,
            __v: number,
            priority: number
        },
        avgTransactionTimeSeconds: number,
        usesAvaxRouter: boolean,
        liveOnRamp: boolean,
        createdAt: string,
        updatedAt: string,
        __v: number,
        priority: number
      },
    ]
  }
}

Get assets

GET https://api.kado.money/v1/ramp/supported-assets

The list of active assets available on Kado.

Get configs

GET https://api.kado.money/v2/public/config

Other Kado configurations, such as available countries, languages, and payment methods.

Once you're comfortable with the custom frontend you've created to buy/sell crypto, you'll want to get a quote for the asset your customer has selected. Make use of all the relevant fiat -> asset quote amount, gas/network fees, and processing fees.

Get quote

GET https://api.kado.money/v2/ramp/quote

The amount of digital assets (BTC, ETH, USDC, etc.) that a user can expect to receive for an input amount of fiat currency (USD, CAD, MXN, etc.).

Query Parameters

Name
Type
Description

transactionType

String

"buy", "sell"

fiatMethod

String

"ach", "debit_card", "credit_card", "apple_pay_credit", "apple_pay_debit", "wire", "sepa", "pix", "koywe"

partner

String

"fortress"

amount

Number

Amount of the fiat/crypto to quote

Default: 100

asset

String

Cryptocurrency name.

Must match the symbol field of an asset from the GET Assets response

Default: BTC

blockchain

String

Blockchain name.

Must match the origin field of a blockchain from the GET Blockchains response

Default: bitcoin

currency

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"

Headers

Name
Type
Description

X-Widget-Id

String

Your frontend integrator API key

🧰
⚒️
We recommend you request getting assets to ensure they are currently available for purchase or sale.
Simply request a quote with the fiat amount, asset ID, and blockchain.