XEROF

REST API reference, v1

XEROF API documentation

Integrate with XEROF's Swiss regulated digital asset infrastructure: authentication, balances, wallets, orders, deposits, transfers, fiat withdrawals and webhooks.

Base URL

https://online.xerof.ch/gateway/api/v1

Version

v1

Security

JWT + Authorization header

OpenAPI

3.0.0

Authentication

The API is authenticated with a JWT sent in the Authorization header. Credentials are issued per client and scoped to that client's account.

    01

    Request access

    API credentials are issued to onboarded clients on request. Contact the middle office and we provision credentials against your account.

    02

    Obtain a token

    Authenticate with your credentials to receive a signed JWT. Tokens are short lived and must be refreshed rather than cached indefinitely.

    03

    Call the API

    Send the token on every request as Authorization: Bearer <token>, over TLS, against the v1 base URL. Requests and responses are JSON.

Example request

GET https://online.xerof.ch/gateway/api/v1/balances
Authorization: Bearer <your-jwt>
Accept: application/json

Endpoints

The v1 surface is grouped by resource. Each group operates only on the assets and accounts held under your own client relationship.

Balances

Read the current balance of every asset held under your account, per currency and per wallet, for reconciliation against your own ledger.

Wallets

List your segregated wallets and their deposit addresses, per asset and per network, so you can present the correct address to a counterparty.

Orders

Create and track conversions between stablecoins, cryptoassets and fiat. Each order returns the executed rate and the XEROF fee as separate lines.

Deposits

Retrieve incoming on-chain and fiat deposits with their status, confirmations, references and the wallet or account they credited.

Transfers

Move assets on chain from your segregated wallet to a whitelisted address, and follow the transfer through to confirmation.

Fiat withdrawals

Instruct payouts in USD, EUR, CHF or GBP to your own or a third-party bank account over Fedwire, SWIFT, SEPA, CHAPS or FPS.

Webhooks

Subscribe to events so your systems are notified when a deposit lands, an order fills or a payout settles, instead of polling.

Conventions

  • All requests and responses are JSON over HTTPS. Unencrypted requests are rejected.
  • Amounts are returned as decimal strings to avoid floating point rounding in your ledger.
  • Every write request should carry your own idempotency reference so a retry cannot duplicate an order or a payout.
  • Rate limits and IP allowlisting are configured per client at the time credentials are issued.
  • Sandbox credentials are available for integration testing before you move to production.

Request API access and we issue credentials, the full OpenAPI specification and sandbox keys.

Talk to our teamBook a callOpen account

Cross-border Services Restrictions

FE Swiss Financial AG (XEROF) is a Swiss Virtual Asset Service Provider, member of the Financial Services Standards Association (VQF), a Swiss Self-Regulatory Organisation under the supervision of Swiss Financial Market Supervisory Authority (FINMA). XEROF's products and services are only regulated in Switzerland. They are not registered or approved outside of Switzerland.

Any information on XEROF's website (i) is not intended and should not be construed as an offer, solicitation or recommendation outside of Switzerland and (ii) may not be suitable or lawful in your jurisdiction.

You are welcome to explore XEROF's website at your own initiative. Click 'Continue' if you are either (i) a resident of, domiciled in, or an entity established in Switzerland, or (ii) are a resident of, domiciled in, or an entity established outside of Switzerland but would like to visit XEROF's site on your own initiative.

If you fall under (ii) above, when choosing 'Continue', it is important to do this on your own initiative, as XEROF is not authorized to promote its products and services outside Switzerland. If you do not wish to visit the site, please click 'Back'.

If you click 'Continue' to explore, please note that you:

  1. are confirming you have read and understood the above;
  2. are accessing XEROF's website at your own initiative, without active promotion or solicitation from XEROF;
  3. are responsible for ensuring access is lawful in your jurisdiction; and
  4. understand that exploring the website does not create a client relationship.