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

# FAQ

> Common questions about the RAVN Integrator API.

<AccordionGroup>
  <Accordion title="Does RAVN use bridges?">
    No. RAVN routes only through RFQ market makers, intent networks, and solver and relayer
    networks that settle in the canonical asset. There is never a lock-and-mint bridge, wrapped
    token, or synthetic.
  </Accordion>

  <Accordion title="Is RAVN custodial?">
    No. The user signs or sends directly to the venue, and RAVN never holds funds. See the
    [Security Model](/security).
  </Accordion>

  <Accordion title="Do I need an API key to start?">
    Not during beta, because the API is open. Just call `https://app.ravn.exchange/api/v1`. Keys
    with per-partner fees and rate limits are issued as the program matures. See
    [Authentication](/authentication).
  </Accordion>

  <Accordion title="How do fees work?">
    A small integrator fee scales with the route. It is 0 bps on commodity same-chain swaps and
    a premium on cross-chain, cross-ecosystem, and native-BTC routes. It is shown transparently
    in every quote and is invisible to your end users. See [Pricing](/pricing).
  </Accordion>

  <Accordion title="What is a quoteToken?">
    An opaque, signed handle returned by `/quote`. Pass it back to `/execute` verbatim, and
    never parse it. It is tamper-evident and it expires.
  </Accordion>

  <Accordion title="How do I handle the different execution types?">
    Branch on the `executionType` field from `/execute`. The values are `TRANSACTION` (sign and
    broadcast), `SIGNATURE` (sign typed data, then RAVN submits it), and `DEPOSIT` (send the
    origin asset to an address). That single field is the whole client contract. See
    [Execution Types](/execution-types).
  </Accordion>

  <Accordion title="Can users swap without holding gas?">
    Yes. On RFQ and gasless venues, the user signs an off-chain message and a solver covers gas.
    They only need the asset they are selling.
  </Accordion>

  <Accordion title="Which chains and assets are supported?">
    EVM chains, Solana, and native Bitcoin. See
    [Supported Chains & Venues](/supported). The `/health` endpoint reports the live venue set.
  </Accordion>

  <Accordion title="How do I track a swap to completion?">
    Poll [`GET /status`](/api-reference/status) with the `statusRef` from `/execute` or
    `/submit-signature`. It returns a normalized lifecycle of `pending`, `processing`, then
    `success`.
  </Accordion>

  <Accordion title="Something failed. How do I get help?">
    Every response includes a `requestId`, which is also in the `x-request-id` header. Include it
    when you reach out via [ravn.exchange](https://ravn.exchange), and we can trace the exact
    request.
  </Accordion>
</AccordionGroup>