Skip to main content

​
Overview

Thiqwave provides a powerful RESTful API for pay-ins, payouts, bridging, on-chain FX, and compliance operations. Whether you’re building a fintech platform, mobile wallet, or payment infrastructure, the Thiqwave API enables seamless value transfer across fiat and stablecoin channels.

​
Base URLs

Production: 
https://api.thiqwave.com/v1/
Staging: 
https://staging.api.thiqwave.com/v1/

​
Authentication

All API requests require the X-API-Key header: 
curl -H "X-API-Key: your_api_key" https://api.thiqwave.com/v1/...
Treat your API key as sensitive. Use environment variables or secure vaults to manage credentials.

​
Amount Formats

Thiqwave uses two distinct amount formats to prevent rounding errors: Fiat currencies (AED, SAR, USD, EUR, GBP, etc.) are represented as integers in the smallest currency unit:
  • 500 AED = 50000 (fils)
  • 100 USD = 10000 (cents)
  • 50 GBP = 5000 (pence)
Stablecoins (USDT, USDC, etc.) are represented as human-readable strings:
  • 500 USDT = "500.00"
  • 1000.50 USDC = "1000.50"

​
Idempotency

All mutating operations (POST requests) support the Idempotency-Key header to ensure safe retries: 
curl -X POST \
  -H "X-API-Key: your_api_key" \
  -H "Idempotency-Key: unique_identifier" \
  https://api.thiqwave.com/v1/payins
If you retry a request with the same Idempotency-Key, you’ll receive the same response without duplicate processing.

​
Endpoints

Quotes

Create and retrieve real-time quotes for any value transfer.

Pay-ins

Initiate fiat or stablecoin deposits to your account.

Payouts

Send fiat to bank accounts or stablecoins to wallets.

Bridging

On-ramp fiat to stablecoin or off-ramp stablecoin to fiat.

On-chain FX

Convert between stablecoins or transfer across blockchains.

Compliance

KYB verification and sanctions screening.

​
Error Handling

The API returns standard HTTP status codes:
StatusMeaning
200Success
201Created
400Bad request (validation error)
401Unauthorized (invalid or missing API key)
403Forbidden (insufficient permissions)
404Not found
409Conflict (e.g., duplicate idempotency key with different params)
429Rate limited
500Server error
Error responses include a structured JSON body: 
{
  "error": {
    "code": "INVALID_AMOUNT",
    "message": "Amount must be greater than 0"
  }
}

​
Rate Limiting

API requests are rate-limited per API key. Check response headers for limits:
  • X-RateLimit-Limit: Requests per second
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: Unix timestamp when limit resets

​
Quote Lock

Quotes expire after 3 minutes. All pay-ins, payouts, and bridge transactions must reference a valid (non-expired) quote via quote_id.

​
Supported Networks

Thiqwave supports stablecoins across the following blockchain networks:
  • Ethereum (ethereum)
  • Base (base)
  • Polygon (polygon)
  • Tron (tron)
  • Stellar (stellar)
  • Solana (solana)
  • XRP Ledger (xrpl)
  • Sui (sui)
  • Hedera (hedera)

​
Supported Currencies

Fiat: AED, SAR, USD, EUR, GBP, and more
Stablecoins: USDT, USDC

​
Next Steps

Start with the Quotes endpoint to understand pricing and rates. Then explore Pay-ins, Payouts, Bridging, and On-chain FX based on your use case.