Appearance
API Reference ​
| Base URL | https://api.valr.com |
| Protocol | HTTPS only |
| Content-Type | application/json |
| Authentication | Signed requests with an institution API key (guide) |
| Permissions | Each endpoint needs one permission, granted by your key's bundles (bundles) |
| Errors | Listed per endpoint (errors) |
| OpenAPI spec | Download openapi.json |
Each endpoint page shows the permission it needs, the bundles that grant it, its request and response, the errors it can return, and code samples that sign the request when they run.
Categories ​
| Category | |
|---|---|
| Account | Balances, sub-accounts and transfers between them, and transaction history. |
| Wallets | Receive and send crypto and fiat, manage saved crypto addresses and linked bank accounts, and track every deposit and withdrawal. |
| Collections | Collect bank deposits from your payers with unique deposit references, then follow each payment to settlement. |
| Payouts | Pay many bank beneficiaries in one batch from your payout account, and track every payout to completion. |
| Webhooks | Get an HTTPS notification when something happens on your business's accounts, instead of polling the API. |
| Public data | Exchange status, server time, currencies and pairs, and market prices, with no API key needed. |