Skip to main content
The Etherfuse API is a REST API. It accepts and returns JSON and uses standard HTTP verbs and status codes. Every endpoint page includes a “Try it” playground and code samples.

​
What is in the reference

  • Payment accounts, quotes and orders (/organization/{organizationId}/*): register the bank accounts and wallets money moves between, price a transfer, create the order and track it. organizationId is your own organization or one of your direct customer organizations. GET /orders lists the orders of your organization and all its customer organizations. Start with Register payment account.
  • Webhook subscriptions (/webhook_subscription*): receive orderUpdated, paymentAccountUpdated, kycUpdated and kybUpdated events. One subscription covers your organization and every customer organization.
  • Organizations, members, KYC and KYB: read your organization and set your default partner fee (/me), create and list customer organizations (/organization, /organizations), manage a business’s members, and verify customers. Start with Create customer organization.
  • Assets, statements and lookup: supported assets, wallet balances, monthly partner statements, and public reference data such as exchange rates and stablebonds. The /lookup/* endpoints need no API key.

​
Base URLs

Build and test against the sandbox first. See Initial Setup. The endpoints are the same in both environments; only the base URL and API key differ.

​
Authentication

Send your API key in the Authorization header, with no Bearer prefix. See Authentication for the sandbox and production key rules.

​
Conventions

Errors

RFC 9457 problem details with a stable type for every error.

Pagination

pageSize and pageNumber query parameters, and one page envelope.

Idempotency

Creating an order twice from the same quote returns the same order.

Webhooks

Signed events that carry the full order or payment account.

​
Use the spec directly

Download openapi-v2.json to import into Postman or Insomnia, or to generate a client. To use natural language instead, connect the MCP server.