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

# Coins Overview

> Add digital-asset trading to your product as an extension of the Daya API

## Introduction

The Coins API is a product extension of the Daya API. It adds digital-asset market data, balances, portfolio, transactions, quote-based trading, and crypto and fiat withdrawals to the same Daya account and the same API key you already use.

<Info>
  Coins is not a separate platform with its own credentials. It uses your existing **Daya API key** with Coins scopes. If you already integrate the Daya API, you only add the Coins surface — nothing about your key issuance or auth changes.
</Info>

## What you can build

<CardGroup cols={2}>
  <Card title="Trading experiences" icon="arrow-right-arrow-left">
    Quote an asset pair, then accept the quote to place a buy or sell order.
  </Card>

  <Card title="Portfolio dashboards" icon="chart-pie">
    Read consolidated balances, holdings, and 24h stats to render a portfolio view.
  </Card>

  <Card title="Funding flows" icon="wallet">
    Surface supported crypto and fiat deposit options so customers can fund.
  </Card>

  <Card title="Treasury and payouts" icon="building-columns">
    Manage saved addresses and bank accounts, then create crypto or fiat withdrawals.
  </Card>
</CardGroup>

## Base URL

All Coins endpoints are served under the Coins path of the Daya API:

```text theme={"dark"}
https://api.daya.co/coins/v1
```

## Authentication in one line

Send your Daya API key in the `X-API-Key` header. The key must carry the relevant Coins scope (`coins:read`, `coins:trade`, `coins:write`, or `coins:withdraw`). See [Authentication](/coins/authentication).

## Two quote types

Coins uses two separate, short-lived quotes. Each response returns an `id`; pass it back as `quote_id` to execute:

* **`POST /quote`** — a **trade** quote between two coins assets. Execute it with `POST /orders`.
* **`POST /fx/quotes`** — a **USD→NGN** conversion quote for cashing out. Execute it with `POST /fiat-withdrawals`.

Both expire after a few seconds, so quote close to the point of execution — an expired quote returns `410 Gone`, a reused one `409 Conflict`. Trade-quote amounts are shown fee-inclusive; the taker fee settles as a separate component at execution.

<Info>
  The execution venue is an internal detail and is never part of the API contract. You request the economic result of a trade; Daya handles routing and settlement.
</Info>

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/coins/quickstart">
    Make your first authenticated Coins call end to end.
  </Card>

  <Card title="Authentication" icon="key" href="/coins/authentication">
    The shared Daya API key model and Coins scopes.
  </Card>

  <Card title="Concepts" icon="book" href="/coins/concepts">
    Balances, quotes, orders, transactions, and withdrawals.
  </Card>

  <Card title="API Reference" icon="code" href="/coins/api-reference/overview">
    Every Coins endpoint, generated from the OpenAPI spec.
  </Card>
</CardGroup>