rates.readGET /api/v2/ratesGET /api/v2/convert
HUILVTONG OPEN PLATFORM
Bring global exchange rates into your product
API v2, official server-side SDKs, signed webhooks and four keyless embed widgets.
REST API v2
Stable, traceable and efficient
currencies.readGET /api/v2/currencies
Search and cursor pagination.
history.readGET /api/v2/history
Up to ten years per query.
data.readGET /api/v2/datasets
Filtered, cursor-based data access.
Request exampleETag and request IDs are returned automatically
curl "https://hl.feihaiwangluo.com/api/v2/convert?amount=100&from=USD&to=CNY" \
-H "X-API-Key: hvt_live_your_key"Create a least-privilege key in Admin → Open API. Keep it in a server-side secret store. Existing API v1 integrations continue to work.
OFFICIAL SDK
Start with PHP or JavaScript
HuilvtongClient
Dependency-free cURL client with all API v2 methods.
Download PHP SDK ↓HuilvtongClient
ES module client with cursor and ETag support.
Download JavaScript SDK ↓PHPNever expose the key in browser code
$client = new Huilvtong\HuilvtongClient(
'https://hl.feihaiwangluo.com',
getenv('HUILVTONG_API_KEY')
);
$result = $client->convert(100, 'USD', 'CNY');SIGNED WEBHOOKS
Receive updates without polling
A new exchange-rate batch is available.
A provider failed and cache fallback may be active.
Verify signing and delivery from the admin area.
Deliveries are HMAC-SHA256 signed, pinned to a public HTTPS address and retried with exponential backoff. Configure endpoints in the admin area.
KEYLESS EMBED WIDGETS
No API key required