> ## Documentation Index
> Fetch the complete documentation index at: https://docs.etherfuse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The Etherfuse REST API — base URLs, auth, and conventions.

The Etherfuse API is organized around **REST**. It has predictable, resource-oriented URLs, accepts and returns JSON, and uses standard HTTP verbs and response codes. Every endpoint on the pages that follow includes a live **"Try it"** playground and copy-paste code samples.

## Two API surfaces

The reference is split into two groups:

* **Ramp API** (`/ramp/*`) — the authenticated partner operations: onboarding, quotes, orders, swaps, customers, wallets, KYC, webhooks, and organizations. Requires an [API key](https://docs.etherfuse.com/authentication.md). Start with [List assets](https://docs.etherfuse.com/api-reference/assets/list-assets.md).
* **Lookup API** (`/lookup/*`) — **public** reference data: exchange rates, stablebonds, bond costs, and country codes. No API key required. Start with [List stablebonds](https://docs.etherfuse.com/api-reference/lookup/list-stablebonds.md).

## Base URLs

| Environment | Base URL |
| - | - |
| **Sandbox** | `https://api.sand.etherfuse.com` |
| **Production** | `https://api.etherfuse.com` |

Build and test against the sandbox first — see [Initial Setup](https://docs.etherfuse.com/initial-setup.md). The endpoints are identical across environments; only the base URL and API key differ.

## Authentication

Send your API key in the `Authorization` header — with **no `Bearer` prefix**. Full details and the sandbox-vs-production key rules are in [Authentication](https://docs.etherfuse.com/authentication.md).

```bash theme={null}
curl https://api.sand.etherfuse.com/ramp/assets \
  -H "Authorization: <your_api_key>"
```

## Conventions

> [card] [Errors](https://docs.etherfuse.com/errors.md)
>
> Standard HTTP status codes (400, 401, 403, 404, 409, 5xx) with a human-readable message.

> [card] [Pagination](https://docs.etherfuse.com/pagination.md)
>
> `POST` list endpoints take `{pageNumber, pageSize, filters}` and return a page envelope.

> [card] [Idempotency](https://docs.etherfuse.com/idempotency.md)
>
> You supply resource UUIDs; reusing one returns `409` instead of creating a duplicate.

> [card] [Webhooks](https://docs.etherfuse.com/webhooks.md)
>
> Signed, real-time events for orders, swaps, KYC, and bank accounts.

## Use the spec directly

[Download `openapi.json`](https://api.etherfuse.com/openapi.json) to import into Postman or Insomnia, or to generate a client. Prefer natural language? Connect the [MCP server](https://docs.etherfuse.com/mcp-overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.