> ## 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.

# Quickstart

> From zero to your first authenticated API call in a few minutes.

This guide gets you to a working API call fast. **You'll need a sandbox API key** — create one in seconds under **Account → Manage Accounts** in the [sandbox dashboard](https://sandbox.etherfuse.com/account/manage) (no approval needed). New here? See [Initial Setup](https://docs.etherfuse.com/initial-setup.md) for full account setup, base URLs, and going to production.

**1. Make your first call**

Use the sandbox base URL `https://api.sand.etherfuse.com` and send your key in the `Authorization` header — **with no `Bearer` prefix** (see [Authentication](https://docs.etherfuse.com/authentication.md)).

A connectivity check is the simplest authenticated request:

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

Or hit a public endpoint that needs no auth — list the available stablebonds:

```bash theme={null}
curl https://api.sand.etherfuse.com/lookup/stablebonds
```

**2. See what your customers can trade**

Once authenticated, discover the assets available to ramp on a given chain. Use the `identifier` from the response when you create a quote.

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

See [GET /ramp/assets](https://docs.etherfuse.com/api-reference/assets/list-assets.md).

**3. Get a quote**

Quotes return pricing (`exchangeRate`, `feeBps`, `feeAmount`, `destinationAmount`) and **expire after 2 minutes**. A quote needs an **onboarded** `customerId`, so complete [onboarding](https://docs.etherfuse.com/guides/onboarding.md) first. The asset pair goes in `quoteAssets` (`type` is `onramp`, `offramp`, or `swap`).

```bash theme={null}
curl -X POST https://api.sand.etherfuse.com/ramp/quote \
  -H "Authorization: <your_sandbox_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "quoteId": "<uuid>",
    "customerId": "<onboarded_customer_uuid>",
    "blockchain": "solana",
    "sourceAmount": "1000",
    "quoteAssets": {
      "type": "onramp",
      "sourceAsset": "MXN",
      "targetAsset": "<token_identifier>"
    }
  }'
```

See [POST /ramp/quote](https://docs.etherfuse.com/api-reference/quotes/get-quote.md) for the full payload, and the path-specific guides below for complete examples.

## Pick your path

> [card] [Onramp](https://docs.etherfuse.com/guides/testing-onramps.md)
>
> Fiat → tokens. The customer deposits MXN and receives tokens.

> [card] [Offramp](https://docs.etherfuse.com/guides/testing-offramps.md)
>
> Tokens → fiat. The customer sends tokens and receives MXN.

> [card] [Swap](https://docs.etherfuse.com/guides/testing-swaps.md)
>
> Token → token. The customer exchanges one asset for another.

## Next steps

> [card] [Onboard customers](https://docs.etherfuse.com/guides/kyc-websdk.md)
>
> Most flows require a KYC'd customer with a linked bank account first.

> [card] [Monitor with webhooks](https://docs.etherfuse.com/guides/verifying-webhooks.md)
>
> Get real-time, HMAC-signed updates instead of polling.

> [card] [Understand the model](https://docs.etherfuse.com/overview.md)
>
> Quote types, fees, order status flows, and resources.

> [card] [Sandbox reference](https://docs.etherfuse.com/test-environment.md)
>
> Test KYC data, sandbox RFCs, and testnet token details.


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