Conversions API

The Conversions API allows you to convert between currencies, optionally using a locked-in quote rate to protect against price fluctuations.

Features

• Currency Conversion - Convert between supported fiat and stablecoin currencies
• Quote-Based Conversions - Lock in a rate with a quote before converting
• Conversion Status - Track the status of your conversions
• Webhook Notifications - Receive real-time updates on conversion status changes

Supported Currencies

Base URL

https://api.esca.finance/v1

Authentication

All endpoints require authentication via API key. Include your API key in the X-Api-Key header:

curl -H "X-Api-Key: your_api_key_here" https://api.esca.finance/v1/conversions

Conversion Flow

1. POST /v1/quotes          (optional) Lock in a rate
2. GET  /v1/quotes/:id      (optional) Check quote status
3. POST /v1/conversions     Execute the conversion
4. GET  /v1/conversions/:id Check conversion status

Conversion Status Flow

PROCESSING -> COMPLETED
           -> FAILED

• PROCESSING - The conversion is being executed asynchronously
• COMPLETED - The conversion completed successfully
• FAILED - The conversion failed

Response Format

All responses follow a consistent format:

{
  "status": true,
  "message": "...",
  "data": { ... }
}