# Kaito Core API

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`.


Version: 2.0.0
License: Apache 2.0

## Servers

Production
```
https://api.kai2.io
```

Sandbox
```
https://sandbox.api.kai2.io
```

## Security

### oAuth2

OAuth2 client credentials. All requests must also be made over mTLS.

Type: oauth2

## Download OpenAPI description

[Kaito Core API](https://developer.kai2.io/_bundle/core.yaml)

## Quotes

Lock pricing and routing

### Create quote

 - [POST /v1/quotes](https://developer.kai2.io/core/quotes/paths/~1v1~1quotes/post.md): Creates a quote for a specific railType and corridor.
Use quotes to lock pricing and routing for a limited time window.

### Get quote by ID

 - [GET /v1/quotes/{quoteId}](https://developer.kai2.io/core/quotes/paths/~1v1~1quotes~1%7Bquoteid%7D/get.md)

## Execution Plans

Multi-step routing plans

### Create execution plan from quote

 - [POST /v1/execution-plans](https://developer.kai2.io/core/execution-plans/paths/~1v1~1execution-plans/post.md): Generates a multi-step routing plan from an existing quote.

### Get execution plan by ID

 - [GET /v1/execution-plans/{planId}](https://developer.kai2.io/core/execution-plans/paths/~1v1~1execution-plans~1%7Bplanid%7D/get.md)

## Payments

Execute payments (CRYPTO_CRYPTO, FIAT_CRYPTO)

### Create payment

 - [POST /v1/payments](https://developer.kai2.io/core/payments/paths/~1v1~1payments/post.md): Creates a payment for CRYPTO_CRYPTO or FIAT_CRYPTO flows.

### List payments

 - [GET /v1/payments](https://developer.kai2.io/core/payments/paths/~1v1~1payments/get.md)

### Get payment by ID

 - [GET /v1/payments/{paymentId}](https://developer.kai2.io/core/payments/paths/~1v1~1payments~1%7Bpaymentid%7D/get.md)

## Payouts

Execute payouts/off-ramp (CRYPTO_FIAT, FIAT_FIAT)

### Create payout (off-ramp)

 - [POST /v1/payouts](https://developer.kai2.io/core/payouts/paths/~1v1~1payouts/post.md): Creates a payout for CRYPTO_FIAT or FIAT_FIAT flows.

### List payouts

 - [GET /v1/payouts](https://developer.kai2.io/core/payouts/paths/~1v1~1payouts/get.md)

### Get payout by ID

 - [GET /v1/payouts/{payoutId}](https://developer.kai2.io/core/payouts/paths/~1v1~1payouts~1%7Bpayoutid%7D/get.md)

## FX Rates

Indicative exchange rates

### Get indicative rates

 - [GET /v1/rates](https://developer.kai2.io/core/fx-rates/paths/~1v1~1rates/get.md): Returns real-time indicative rates. For firm rates, use FX quotes.

## FX Quotes

Firm FX quotes

### Create FX quote

 - [POST /v1/fx-quotes](https://developer.kai2.io/core/fx-quotes/paths/~1v1~1fx-quotes/post.md): Creates a firm FX quote locked for a short time window.

### Get FX quote by ID

 - [GET /v1/fx-quotes/{quoteId}](https://developer.kai2.io/core/fx-quotes/paths/~1v1~1fx-quotes~1%7Bquoteid%7D/get.md)

## Corridors

Supported corridors

### List supported corridors

 - [GET /v1/corridors](https://developer.kai2.io/core/corridors/paths/~1v1~1corridors/get.md): Returns all supported currency corridors and their constraints.