# Etherfuse FX API

## Docs

- [Accept customer agreement](https://docs.etherfuse.com/api-reference/agreements/accept-customer-agreement.md): Records the user's acceptance of the Customer Agreement, which governs the use of Etherfuse's on/off ramp services.
- [Accept electronic signature consent](https://docs.etherfuse.com/api-reference/agreements/accept-electronic-signature-consent.md): Records the user's consent to conduct business electronically (E-Sign Act compliance).
- [Accept terms and conditions](https://docs.etherfuse.com/api-reference/agreements/accept-terms-and-conditions.md): Records the user's acceptance of Etherfuse's Terms and Conditions.
- [Get rampable assets](https://docs.etherfuse.com/api-reference/assets/get-rampable-assets.md): Returns all rampable stablecoins (e.g., USDC, EURC) and stablebonds (e.g., CETES) available on the specified blockchain. The `currency` parameter controls sort priority — assets matching the requested currency appear first in the list, but all rampable assets for the chain are always returned. Use t…
- [Create bank account (API key)](https://docs.etherfuse.com/api-reference/bank-accounts/create-bank-account-api-key.md): Programmatically creates a new bank account for a customer using API key authentication. No presigned URL is required. The account registration data (name, CURP, RFC, CLABE, etc.) is validated and sent to the payment processor. Bank accounts require verification before they can be used for transacti…
- [Create bank account (presigned URL)](https://docs.etherfuse.com/api-reference/bank-accounts/create-bank-account-presigned-url.md): Registers a customer's Mexican bank account (CLABE) for on/off-ramp transactions. The `account` field accepts two variants — Personal or Business — auto-detected based on the fields present.
- [Get bank account details](https://docs.etherfuse.com/api-reference/bank-accounts/get-bank-account-details.md): Retrieves details for a specific bank account
- [List bank accounts](https://docs.etherfuse.com/api-reference/bank-accounts/list-bank-accounts.md): Returns the first page of bank accounts with defaults (pageSize 30, pageNumber 0, no filters). Use the POST variant for pagination and date filtering.
- [List bank accounts (with pagination)](https://docs.etherfuse.com/api-reference/bank-accounts/list-bank-accounts-with-pagination.md): Retrieves a paginated list of bank accounts. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters).
- [Delete a crypto wallet](https://docs.etherfuse.com/api-reference/crypto-wallets/delete-a-crypto-wallet.md): Soft-deletes a crypto wallet and releases any claimed ownership associated with it. The wallet can be re-registered later via `POST /ramp/wallet`.
- [Get wallet details](https://docs.etherfuse.com/api-reference/crypto-wallets/get-wallet-details.md): Retrieves details for a specific crypto wallet
- [List crypto wallets](https://docs.etherfuse.com/api-reference/crypto-wallets/list-crypto-wallets.md): Returns the first page of crypto wallets with defaults (pageSize 30, pageNumber 0, no filters). Use the POST variant for pagination and date filtering.
- [List crypto wallets (with pagination)](https://docs.etherfuse.com/api-reference/crypto-wallets/list-crypto-wallets-with-pagination.md): Retrieves a paginated list of crypto wallets. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters).
- [Register a crypto wallet](https://docs.etherfuse.com/api-reference/crypto-wallets/register-a-crypto-wallet.md): Registers a crypto wallet for the authenticated organization. If the wallet was previously soft-deleted, it will be restored.
- [Register a wallet for a child org customer](https://docs.etherfuse.com/api-reference/crypto-wallets/register-a-wallet-for-a-child-org-customer.md): Registers a crypto wallet for a customer that belongs to the caller's organization or a direct child organization. This mirrors `POST /ramp/wallet` but is scoped to a specific customer within the caller's org hierarchy.
- [Get customer bank accounts](https://docs.etherfuse.com/api-reference/customers/get-customer-bank-accounts.md): Returns the first page of bank accounts for a specific customer with defaults (pageSize 30, pageNumber 0, no filters). Use the POST variant for pagination and date filtering.
- [Get customer bank accounts (with pagination)](https://docs.etherfuse.com/api-reference/customers/get-customer-bank-accounts-with-pagination.md): Retrieves bank accounts for a specific customer. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters).
- [Get customer crypto wallets](https://docs.etherfuse.com/api-reference/customers/get-customer-crypto-wallets.md): Returns the first page of crypto wallets for a specific customer with defaults (pageSize 30, pageNumber 0, no filters). Use the POST variant for pagination and date filtering.
- [Get customer crypto wallets (with pagination)](https://docs.etherfuse.com/api-reference/customers/get-customer-crypto-wallets-with-pagination.md): Retrieves crypto wallets for a specific customer. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters).
- [Get customer details](https://docs.etherfuse.com/api-reference/customers/get-customer-details.md): Retrieves details for a specific customer
- [Get customer orders](https://docs.etherfuse.com/api-reference/customers/get-customer-orders.md): Returns the first page of orders for a specific customer with defaults (pageSize 30, pageNumber 0, no filters). Use the POST variant for pagination and date filtering.
- [Get customer orders (with pagination)](https://docs.etherfuse.com/api-reference/customers/get-customer-orders-with-pagination.md): Retrieves orders for a specific customer. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters).
- [List customers](https://docs.etherfuse.com/api-reference/customers/list-customers.md): Returns the first page of customers with defaults (pageSize 30, pageNumber 0, no filters). Use the POST variant for pagination and date filtering.
- [List customers (with pagination)](https://docs.etherfuse.com/api-reference/customers/list-customers-with-pagination.md): Retrieves a paginated list of customers. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters).
- [Get KYC status](https://docs.etherfuse.com/api-reference/kyc/get-kyc-status.md): Check the current KYC verification status for a customer's wallet.
- [Submit KYC identity data](https://docs.etherfuse.com/api-reference/kyc/submit-kyc-identity-data.md): Submit identity information (name, address, DOB, tax ID) for a customer programmatically. This is an alternative to the presigned URL flow where users complete KYC in the Etherfuse UI.
- [Upload KYC documents](https://docs.etherfuse.com/api-reference/kyc/upload-kyc-documents.md): Upload identity documents (government ID, selfie) for a customer.
- [Get all bond costs](https://docs.etherfuse.com/api-reference/lookup/get-all-bond-costs.md): Returns current pricing data for all stablebonds, including the bond cost in USD, fiat, and per-provider exchange rate sources. Each bond entry includes a `sources` map showing the exchange rate and derived `bond_cost_in_usd` from each FX provider, enabling oracle safety checks. This endpoint is pub…
- [Get all exchange rates](https://docs.etherfuse.com/api-reference/lookup/get-all-exchange-rates.md): Returns current USD exchange rates for all supported currencies. This endpoint is public and does not require authentication.
- [Get all stablebonds](https://docs.etherfuse.com/api-reference/lookup/get-all-stablebonds.md): Returns a list of all stablebonds with their current prices, supplies, and multi-chain breakdown. This endpoint is public and does not require authentication. Data is cached for 5 minutes.
- [Get bond cost by mint or symbol](https://docs.etherfuse.com/api-reference/lookup/get-bond-cost-by-mint-or-symbol.md): Returns current pricing data for a single stablebond, including the bond cost in USD, fiat, and per-provider exchange rate sources. The `identifier` can be either a Solana mint address (e.g., `CETES7CKqqKQizuSN6iWQwmTeFRjbJR6Vw2XRKfEDR8f`) or a bond symbol (e.g., `CETES`). This endpoint is public an…
- [Get country codes](https://docs.etherfuse.com/api-reference/lookup/get-country-codes.md): Returns the list of supported countries with ISO 3166-1 alpha-2 codes, alpha-3 codes, and English names. Use these codes for `birthCountryIsoCode` and `countryIsoCode` fields when registering bank accounts. This endpoint is public and does not require authentication.
- [Get current organization identity](https://docs.etherfuse.com/api-reference/lookup/get-current-organization-identity.md): Returns the identity of the organization associated with the current API key. Useful for verifying which organization your API key belongs to.
- [Get specific exchange rate](https://docs.etherfuse.com/api-reference/lookup/get-specific-exchange-rate.md): Returns the current USD to specified currency exchange rate. This endpoint is public and does not require authentication.
- [Generate onboarding URL](https://docs.etherfuse.com/api-reference/onboarding/generate-onboarding-url.md): Generates a presigned URL for customer onboarding. If the customer does not exist, it will be created.
- [Get onboarding bank accounts](https://docs.etherfuse.com/api-reference/onboarding/get-onboarding-bank-accounts.md): Retrieves bank accounts for onboarding process
- [Cancel an order](https://docs.etherfuse.com/api-reference/orders/cancel-an-order.md): Cancels an order that is in `created` status. Only orders accessible to your API key can be canceled.
- [Create a new order](https://docs.etherfuse.com/api-reference/orders/create-a-new-order.md): Creates a new order for crypto/fiat conversion using a previously created quote.
- [Generate EVM token approval transaction](https://docs.etherfuse.com/api-reference/orders/generate-evm-token-approval-transaction.md): Generates an unsigned ERC20 `approve()` transaction that enables gasless offramps on EVM chains. When this feature is enabled for your organization, EVM offramp transactions no longer require the user to hold native gas tokens (e.g., ETH on Base) for the cross-chain bridging fee — Etherfuse covers t…
- [Get order details](https://docs.etherfuse.com/api-reference/orders/get-order-details.md): Retrieves details for a specific order accessible to your API key.
- [List orders](https://docs.etherfuse.com/api-reference/orders/list-orders.md): Returns the first page of orders with defaults (pageSize 30, pageNumber 0, no filters). Use the POST variant for pagination and date filtering.
- [List orders (with pagination)](https://docs.etherfuse.com/api-reference/orders/list-orders-with-pagination.md): Retrieves a paginated list of orders accessible to your API key. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters).
- [Preview order details](https://docs.etherfuse.com/api-reference/orders/preview-order-details.md): Calculates and returns preview details for an order
- [Regenerate transaction](https://docs.etherfuse.com/api-reference/orders/regenerate-transaction.md): Regenerates a pre-built transaction for an order.
- [Create a child organization](https://docs.etherfuse.com/api-reference/organizations/create-a-child-organization.md): Creates a new child organization under the caller's organization. The child org is created in an unapproved state — approval happens separately through the Etherfuse approval workflow.
- [Rename an organization](https://docs.etherfuse.com/api-reference/organizations/rename-an-organization.md): Renames the caller's own organization or a direct child organization. The caller's organization is resolved from the API key.
- [Set partner fee default](https://docs.etherfuse.com/api-reference/organizations/set-partner-fee-default.md): Sets the default partner fee (in basis points) for an organization. The caller must be an admin member of the target organization. The fee is capped at 500 bps (5.00%).
- [Get quote for conversion](https://docs.etherfuse.com/api-reference/quotes/get-quote-for-conversion.md): Retrieves a quote for converting between assets. Supports three quote types: - **Onramp**: fiat to crypto (sourceAsset: fiat currency code, targetAsset: asset identifier) - **Offramp**: crypto to fiat (sourceAsset: asset identifier, targetAsset: fiat currency code) - **Swap**: crypto to crypto (sour…
- [Regenerate swap transaction](https://docs.etherfuse.com/api-reference/swap/regenerate-swap-transaction.md): Regenerates a transaction for a swap. Useful for cases where the transaction was not submitted prior to expiration. The updated transaction will be returned via the swap_updated webhook. Returns HTTP 202 Accepted if successful.
- [Swap assets](https://docs.etherfuse.com/api-reference/swap/swap-assets.md): Swaps two different crypto assets. This endpoint is asynchronous and returns an HTTP 200 OK with an empty body.
- [Create webhook](https://docs.etherfuse.com/api-reference/webhooks/create-webhook.md): Creates a new webhook for event notifications
- [Delete webhook](https://docs.etherfuse.com/api-reference/webhooks/delete-webhook.md): Deletes a specific webhook
- [Get webhook details](https://docs.etherfuse.com/api-reference/webhooks/get-webhook-details.md): Retrieves details for a specific webhook
- [List webhooks](https://docs.etherfuse.com/api-reference/webhooks/list-webhooks.md): Retrieves a paginated list of webhooks
- [Onboard Customers](https://docs.etherfuse.com/guides/onboarding.md): How to onboard and verify customers in the sandbox environment
- [Onboard — Hosted UI](https://docs.etherfuse.com/guides/onboarding-hosted.md): Onboard customers using Etherfuse's hosted verification page
- [Onboard — Programmatic](https://docs.etherfuse.com/guides/onboarding-programmatic.md): Onboard customers via API for a white-label experience
- [Add Wallets & Bank Accounts](https://docs.etherfuse.com/guides/registering-accounts.md): Set up the wallets and bank accounts your organization needs before creating orders
- [Test Offramps](https://docs.etherfuse.com/guides/testing-offramps.md): How to test offramp flows in the sandbox environment
- [Test Onramps](https://docs.etherfuse.com/guides/testing-onramps.md): How to test onramp flows in the sandbox environment
- [Test Swaps](https://docs.etherfuse.com/guides/testing-swaps.md): How to test crypto-to-crypto swap flows in the sandbox environment
- [Verifying Webhooks](https://docs.etherfuse.com/guides/verifying-webhooks.md): How to verify webhook signatures to ensure payloads are authentic
- [Initial Setup](https://docs.etherfuse.com/initial-setup.md): Set up your sandbox account and start integrating with the FX API
- [MCP Server](https://docs.etherfuse.com/mcp-overview.md): Connect your preferred LLM to the Etherfuse FX API using our MCP server
- [Overview](https://docs.etherfuse.com/overview.md): Overview of the FX API
- [Simulate Fiat Received](https://docs.etherfuse.com/sandbox-api/fiat-received.md): Simulate the receipt of fiat funds for an onramp order (Sandbox only)
- [Sandbox Reference](https://docs.etherfuse.com/test-environment.md): Testing details for the Etherfuse sandbox environment

## OpenAPI Specs

- [openapi](https://docs.etherfuse.com/openapi.yaml)