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

# Reference APIs

> Discover instruments and metadata before requesting market data

<div style={{ width: '100%', height: 240, marginBottom: 32, borderRadius: 16, overflow: 'hidden', position: 'relative' }}>
  <video style={{ width: '100%', height: '100%', objectFit: 'cover', filter: 'sepia(0.3) saturate(1.5) hue-rotate(-14deg) brightness(0.72) contrast(1.12)' }} autoPlay loop muted playsInline>
    <source src="https://mintcdn.com/vero-fa5575b5/G_sL_RHXpWEXOwUp/images/bg_video.mp4?fit=max&auto=format&n=G_sL_RHXpWEXOwUp&q=85&s=f731a6a676fb99a2368193fbaf3281ee" type="video/mp4" data-path="images/bg_video.mp4" />
  </video>
</div>

<div style={{ width: '100%', height: 4, marginBottom: 24, borderRadius: 2, background: 'rgba(0,0,0,0.08)' }}>
  <div style={{ width: '50%', height: '100%', borderRadius: 2, background: 'linear-gradient(90deg, var(--accent-primary) 0%, var(--accent-light) 50%, var(--accent-dark) 100%)' }} />
</div>

Reference APIs help clients search and validate symbols before requesting detailed data.

<CardGroup cols={2}>
  <Card title="List instruments" icon="list">
    Search instruments by asset class, exchange and symbol prefix.
  </Card>

  <Card title="Get instrument" icon="circle-info">
    Fetch metadata for a single instrument.
  </Card>
</CardGroup>

## Endpoints

| Endpoint                       | Purpose                                   |
| ------------------------------ | ----------------------------------------- |
| `GET /v1/instruments`          | Search and paginate available instruments |
| `GET /v1/instruments/{symbol}` | Fetch one instrument                      |

## Use cases

* Symbol autocomplete
* Symbol validation before ticks or candles
* Universe filtering by asset class or exchange
* Displaying metadata such as base, quote, currency and status

## Try it

<CardGroup cols={2}>
  <Card title="List instruments" icon="play" href="/en/apis/reference/list-instruments">
    Open the playground to search instruments.
  </Card>

  <Card title="Get instrument" icon="play" href="/en/apis/reference/get-instrument">
    Open the playground to fetch one symbol.
  </Card>
</CardGroup>