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

## Supported assets

The catalog carries two tiers of assets:

* **Majors and stablecoins** — curated assets (BTC, ETH, USDC, USDT, …) across their native networks.
* **Memecoins and long-tail tokens** — resolved by contract address and tradable **only on BSC, Robinhood Chain, and Solana**.

<Warning>
  Memecoin support is limited to **BSC (`bsc`), Robinhood Chain (`robinhood`), and Solana (`solana`)**. A token on any other network cannot be listed, quoted, or traded — `GET /by-contract` will not resolve it and `POST /quote` will reject it.
</Warning>

Every asset is identified by its caid (`<chain>:<contract>` or `<chain>:native`), e.g. `bsc:0x2859…`, `solana:EPjF…`, `robinhood:0x9fa2…`.

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


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