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

# API Introduction

> Two surfaces, one router. Fuse API and Trade API.

DZap exposes two HTTP surfaces:

| API           | Base URL              | Auth                      | Use for                             |
| ------------- | --------------------- | ------------------------- | ----------------------------------- |
| **Fuse API**  | `https://zap.dzap.io` | None (per-IP rate limits) | Intent execution, bundles, gasless  |
| **Trade API** | `https://api.dzap.io` | Optional API key          | Swaps, bridges, DCA, tokens, status |

Both speak JSON over HTTPS. Both run on the same routing engine.

## Pick one

<CardGroup cols={2}>
  <Card title="Fuse API" icon="bolt" href="/api/fuse/quote">
    OpenAPI-backed. Quote, build, bundle, execute, status.
  </Card>

  <Card title="Trade API" icon="arrows-rotate" href="/api/trade/overview">
    REST routes for the full Core surface plus DCA and webhooks.
  </Card>
</CardGroup>

## Conventions

* **Amounts are strings in wei** - `"1000000"` is 1 USDC (6 decimals), not `1`.
* **Native tokens** use the sentinel `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE`. Never the zero address.
* **Slippage is percent** — `1` = 1%, `0.5` = 0.5%.
* **Errors** follow `{ "status": "error", "code": "...", "message": "..." }`. See [Error Codes](/api/error-codes).
* **Webhooks** should verify `DZap-Signature` with HMAC-SHA-256 over the raw request body. See [Webhooks](/api/webhooks).

## Status & rate limits

| Aspect             | Fuse API                              | Trade API                       |
| ------------------ | ------------------------------------- | ------------------------------- |
| Health endpoint    | `GET /v1/status`                      | `GET /v1/status`                |
| Default rate limit | 3 req/sec on quote/buildTx            | Per-key (or per-IP fallback)    |
| Auth               | None                                  | Bearer-style API key (optional) |
| Response time SLA  | Typical: \<200ms quote, \<500ms build | Typical: \<300ms quote          |

See [Authentication](/api/authentication) and [Rate Limits](/api/rate-limits).

## Versioning

All endpoints are under `/v1`. Breaking changes ship under `/v2`; `/v1` stays available with at least 90 days notice. Watch the [changelog](/resources/changelog).
