The Haidrun API
A versioned REST API for regulated digital money — issue stablecoins, move value, manage wallets and run compliance, all with deterministic settlement. Secured with OAuth 2.0 and mutual TLS, documented with OpenAPI.
// request { "from": "wallet_9f2a…", "to": "wallet_7c1b…", "amount": "240000.00", "currency": "EUR" } // 201 Created { "id": "pay_1a2b…", "status": "settled", "finality_ms": 420 }
One API for the full money lifecycle
Every capability of the platform is reachable over industry-standard REST — no custom protocol development. Group your integration around the endpoints you need.
OAuth 2.0 + JWT
Exchange client credentials for a short-lived access token with refresh-token rotation. Every request is authenticated and scoped.
Payments & settlement
Submit transfers and settlements — domestic and cross-border, B2B and B2C — with deterministic finality in under 500 ms.
Custodial accounts
Create and manage per-client custodial wallets, query balances and inspect transaction history.
Mint & burn (HSC)
Issue and redeem your own backed stablecoin against reserves — supply is always derivable from chain state.
Identity & onboarding
Run tiered identity verification, beneficial-owner checks and sanctions/PEP screening as part of onboarding.
MiCA Art. 71
Register and track complaints through the workflow built for regulatory obligations.
From credentials to confirmed transaction
Authenticate once, then call the API. Two illustrative requests to show the shape of an integration.
// request — client credentials { "grant_type": "client_credentials", "client_id": "cid_live_…", "client_secret": "•••" } // 200 OK { "access_token": "eyJhbGciOi…", "token_type": "Bearer", "expires_in": 900 }
// Authorization: Bearer ••• { "amount": "1000000", "to": "wallet_7c1b…", "reference": "treasury-01" } // 201 Created { "status": "settled", "tx": "0x…" }
The public surface at a glance
A high-level view of the endpoint groups. Full method-by-method detail — schemas, parameters, error codes and webhooks — lives in the developer reference.
| Group | Base path | What it does |
|---|---|---|
| Authentication | /v1/auth | Token issuance and refresh-token rotation (OAuth 2.0). |
| Transactions | /v1/payments | Submit and query payments and settlements. |
| Wallets | /v1/wallets | Create custodial wallets, read balances and history. |
| Stablecoins | /v1/stablecoins | Mint, burn and query supply for your HSC. |
| KYC / KYB | /v1/kyc | Identity verification, screening and onboarding status. |
| Complaints | /v1/complaints | Register and track complaints (MiCA Art. 71). |
Go deeper when you need to
Native SDK
Build directly on Layer 1 without third-party API overhead — full access to the settlement and execution engine.
HVM · Solidity
Deploy EVM-compatible smart contracts with standard tooling and parallel, deterministic execution.
Webhooks
Receive transaction confirmations with exactly-once semantics — final and irreversible.
Everything an engineer needs — in one place.
The complete developer reference goes far beyond this page: every endpoint and method, request and response schemas, error model and status codes, pagination and idempotency, the full OAuth flow, webhook events and signatures, rate limits, and SDK & HVM guides — with copy-paste examples throughout.
It's available to approved developers in the developer portal. Tell us what you're building and we'll get you access.
Authentication & tokens Requests, versioning & errors Pagination & idempotency Payments /v1/payments Wallets /v1/wallets Stablecoins /v1/stablecoins KYC / KYB /v1/kyc Complaints /v1/complaints Webhooks & signatures Rate limits SDK & HVM guides ────────────────────────── 🔒 Full detail on request access
Start building on Haidrun
Request developer access and tell us what you're building — we'll open the full reference and a sandbox.