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

# Stocks Overview

> Add US-stock trading to your product as an extension of the Daya API

## Introduction

The Stocks API is a product extension of the Daya API. It adds US-stock market data, USD balances, portfolio, transactions, quote-based order placement, and fiat withdrawals to the same Daya account and the same API key you already use.

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

## What you can build

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

  <Card title="Portfolio dashboards" icon="chart-pie">
    Read USD cash balance and holdings to render a portfolio view.
  </Card>

  <Card title="Market discovery" icon="magnifying-glass-chart">
    Search, rank, and sort the asset catalog to surface trending stocks.
  </Card>

  <Card title="Cash out" icon="building-columns">
    Manage payout bank accounts, then create fiat withdrawals.
  </Card>
</CardGroup>

## Base URL

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

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

## Authentication in one line

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

## Market hours and USD-denominated trading

Stocks trade in USD notional. Each asset reports its `market_status`, whether the market `is_market_open`, and off-hours eligibility, so you can gate order placement to the right session. Orders are quote-driven: request a priced quote, then accept it to execute.

## Next steps

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

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

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

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