Skip to main content

​
Get On-chain FX

Retrieve the full details of an on-chain FX transaction by its ID, including conversion rates, fees, and current status.

​
Endpoint

GET /v1/onchain-fx/:id

​
Request

curl https://api.thiqwave.com/v1/onchain-fx/fx_1234567890 \
  -H "X-API-Key: your_api_key"

​
Response

{
  "fx_id": "fx_1234567890",
  "quote_id": "quote_3333333333",
  "status": "completed",
  "source_currency": "USDT",
  "source_network": "ethereum",
  "source_address": "0x123456789abcdef123456789abcdef1234567890",
  "source_amount": "1000.00",
  "destination_currency": "USDC",
  "destination_network": "polygon",
  "destination_address": "0xabcdef123456789abcdef123456789abcdef1234",
  "destination_amount": "999.50",
  "exchange_rate": "0.9995",
  "fees": {
    "platform_fee": "0.50",
    "network_fee": "0.00"
  },
  "created_at": "2026-04-09T14:30:00Z",
  "completed_at": "2026-04-09T14:32:00Z"
}

​
Response Fields

FieldTypeDescription
fx_idstringUnique on-chain FX transaction identifier.
quote_idstringAssociated quote ID.
statusstringCurrent status: pending, processing, completed, failed.
source_currencystringSource stablecoin.
source_networkstringSource blockchain network.
source_addressstringSource wallet address.
source_amountstringAmount in source currency (human-readable).
destination_currencystringDestination stablecoin.
destination_networkstringDestination blockchain network.
destination_addressstringDestination wallet address.
destination_amountstringAmount in destination currency (human-readable).
exchange_ratestringConversion rate (destination per source).
feesobjectPlatform and network fees breakdown.
created_atstringISO 8601 timestamp of creation.
completed_atstring | nullISO 8601 timestamp of completion.

​
Notes

  • Check the status field to determine the current state of the FX transaction.
  • Use the fx_id to track the transaction in your system.
  • Once status becomes completed, stablecoins have been converted and delivered to the destination address.
  • Exchange rates are locked during the quote validity period (3 minutes).