Create a new customer in Stables for KYC verification and transfers. Use 'individual' for personal accounts or 'business' for company accounts. Include entitlements like 'base_payout' to enable transactions.

Get details about a specific customer including their verification status

List all customers for the authenticated tenant

Generate a KYC verification link for a customer. The customer must complete verification before they can make transfers.

Update customer details, entitlements, or verification information

Update customer metadata key-value pairs

Get a quote for currency exchange. Quotes show the exchange rate, fees, and amount the customer will receive. Quotes expire after 30 seconds. Currently supports crypto → fiat (off-ramp) with more types coming soon.

Get details about an existing quote including its current status

Execute a transfer using an active quote. The quote must not be expired. This initiates the actual money movement. Bank/payment details are required for off-ramp (crypto to fiat) transfers.

Get the current status and details of a transfer

List transfers with optional filters for status, type, or customer

Create a virtual bank account for a customer to receive fiat deposits. Deposits can automatically convert to crypto and payout to a wallet.

List all virtual accounts for a customer

Update virtual account settings (e.g., deposit handling mode)

Deactivate a virtual account to prevent new incoming transactions

Reactivate a previously deactivated virtual account

Get the activity history for a virtual account (deposits, payouts, etc.)

Create a new API key for accessing the Stables API. The secret key is only shown once on creation - save it immediately.

List all API keys for the current account

Get details about a specific API key

Revoke an API key. This permanently disables the key and cannot be undone.

Subscribe to Stables events via webhook. You'll receive POST requests to your URL when events occur.

Available event types:

• WEBHOOK_EVENT_TYPE_CUSTOMER_CREATED

• WEBHOOK_EVENT_TYPE_CUSTOMER_UPDATED

• WEBHOOK_EVENT_TYPE_KYC_STATUS_CHANGED

• WEBHOOK_EVENT_TYPE_PAYMENT_CREATED

• WEBHOOK_EVENT_TYPE_PAYMENT_STATUS_CHANGED

• WEBHOOK_EVENT_TYPE_QUOTE_CREATED

• WEBHOOK_EVENT_TYPE_QUOTE_EXPIRED

• WEBHOOK_EVENT_TYPE_VA_DEPOSIT_RECEIVED

• WEBHOOK_EVENT_TYPE_VA_PAYOUT_COMPLETED

• WEBHOOK_EVENT_TYPE_VA_PAYOUT_FAILED

• WEBHOOK_EVENT_TYPE_MONOOVA_NPP_RECEIVE_PAYMENT

• WEBHOOK_EVENT_TYPE_MONOOVA_INBOUND_DIRECT_CREDIT

• WEBHOOK_EVENT_TYPE_ALL

Security: Set a secret to enable HMAC-SHA256 signature verification via X-Webhook-Signature header.

List all webhook subscriptions for the current account

Delete a webhook subscription. You will stop receiving events at this endpoint.

Send a KYC verification link to a customer via SMS. Automatically fetches the customer's phone number and generates a fresh verification link. Requires TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, and TWILIO_PHONE_NUMBER environment variables.