# Kaito Platform API

Platform services including webhooks and blockchain gateway operations.

**Webhooks:** Register endpoints for event notifications. Kaito signs requests using HMAC-SHA256 with `Kaito-Timestamp` and `Kaito-Signature` headers. Events include payment, payout, quote, checkout, identity, and acceptance categories.

**Chain Gateway:** Low-level blockchain operations for Ethereum, Polygon, Solana, and Bitcoin. Includes fee estimation and transaction broadcast for partners managing their own key material.


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 Platform API](https://developer.kai2.io/_bundle/platform.yaml)

## Webhook Endpoints

Manage webhook subscriptions

### Register webhook endpoint

 - [POST /v1/webhooks/endpoints](https://developer.kai2.io/platform/webhook-endpoints/paths/~1v1~1webhooks~1endpoints/post.md): Register a new webhook endpoint to receive event notifications.

Important: The webhook secret is only returned once at creation time.
Store it securely for signature verification.

### List webhook endpoints

 - [GET /v1/webhooks/endpoints](https://developer.kai2.io/platform/webhook-endpoints/paths/~1v1~1webhooks~1endpoints/get.md)

### Get webhook endpoint

 - [GET /v1/webhooks/endpoints/{endpointId}](https://developer.kai2.io/platform/webhook-endpoints/paths/~1v1~1webhooks~1endpoints~1%7Bendpointid%7D/get.md)

### Update webhook endpoint

 - [PATCH /v1/webhooks/endpoints/{endpointId}](https://developer.kai2.io/platform/webhook-endpoints/paths/~1v1~1webhooks~1endpoints~1%7Bendpointid%7D/patch.md)

### Delete webhook endpoint

 - [DELETE /v1/webhooks/endpoints/{endpointId}](https://developer.kai2.io/platform/webhook-endpoints/paths/~1v1~1webhooks~1endpoints~1%7Bendpointid%7D/delete.md)

## Event Types

List available event types

### List available event types

 - [GET /v1/webhooks/event-types](https://developer.kai2.io/platform/event-types/paths/~1v1~1webhooks~1event-types/get.md)

## Fee Estimation

Estimate network fees

### Estimate network fee for a transfer

 - [POST /v1/chain/estimate-fee](https://developer.kai2.io/platform/fee-estimation/paths/~1v1~1chain~1estimate-fee/post.md): Estimate the network fee for a transfer.
Returns fee estimates for different speed tiers (slow, standard, fast).

## Transaction Broadcast

Broadcast signed transactions

### Broadcast signed transaction

 - [POST /v1/chain/broadcast](https://developer.kai2.io/platform/transaction-broadcast/paths/~1v1~1chain~1broadcast/post.md): Broadcast a signed transaction to the network.
Returns the transaction hash and submission status.

### Get transaction status

 - [GET /v1/chain/transaction/{network}/{txHash}](https://developer.kai2.io/platform/transaction-broadcast/paths/~1v1~1chain~1transaction~1%7Bnetwork%7D~1%7Btxhash%7D/get.md): Check the status of a previously broadcast transaction.