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

# Market data

> Public price feeds, orderbook, recent trades, symbol catalog, and per-symbol metadata — no authentication required.

Market data endpoints are **public** — no `X-API-Key` or `X-API-Secret` headers needed.

```
BASE = https://engine.dojifunded.com/v1
```

***

## Price

```bash theme={null}
GET /v1/price?symbol=BTC-USD
```

Returns the last price, mark price, and index price for a symbol.

```bash theme={null}
curl "$BASE/price?symbol=BTC-USD"
```

<ParamField query="symbol" type="string" required>
  Tradable symbol. Variants like `BTCUSD`, `BTC/USD`, and `btc-usd` are resolved automatically.
</ParamField>

***

## Orderbook

```bash theme={null}
GET /v1/orderbook?symbol=BTC-USD&depth=24
```

Aggregated order book. Default depth is 24 levels; the maximum is defined in engine config.

```bash theme={null}
curl "$BASE/orderbook?symbol=BTC-USD&depth=24"
```

<ParamField query="symbol" type="string" required>
  Tradable symbol.
</ParamField>

<ParamField query="depth" type="number">
  Number of price levels to return per side. Default: `24`.
</ParamField>

***

## Recent trades

```bash theme={null}
GET /v1/trades?symbol=BTC-USD&limit=100
```

Latest public trade feed for a symbol.

```bash theme={null}
curl "$BASE/trades?symbol=BTC-USD&limit=100"
```

<ParamField query="symbol" type="string" required>
  Tradable symbol.
</ParamField>

<ParamField query="limit" type="number">
  Number of trades to return. Capped per endpoint config.
</ParamField>

***

## Tickers

```bash theme={null}
GET /v1/tickers
```

Full catalog of tradable symbols, grouped by asset class. Use this to discover valid values for the `symbol` field in order requests.

```bash theme={null}
curl "$BASE/tickers"
```

***

## Ticker metadata

```bash theme={null}
GET /v1/ticker/metadata?ticker=BTC-USD&type=crypto
```

Per-symbol trading parameters.

```bash theme={null}
curl "$BASE/ticker/metadata?ticker=BTC-USD&type=crypto"
```

<ParamField query="ticker" type="string" required>
  Symbol to look up. Fuzzy matching accepted — `BTCUSD`, `BTC/USD`, and `btc-usd` all resolve.
</ParamField>

<ParamField query="type" type="string">
  Asset class hint: `crypto`, `equity`, etc. Helps disambiguation when the same ticker exists across classes.
</ParamField>

**Response fields**

<ResponseField name="tick_size" type="number">
  Minimum price increment.
</ResponseField>

<ResponseField name="lot_size" type="number">
  Minimum quantity increment.
</ResponseField>

<ResponseField name="max_leverage" type="number">
  Maximum leverage allowed for this symbol.
</ResponseField>

<ResponseField name="funding_cadence" type="string">
  Funding interval (e.g. `8h`).
</ResponseField>

***

## Engine config

```bash theme={null}
GET /v1/config
```

Engine-wide configuration: default book depths, supported venues, and feature flags.

```bash theme={null}
curl "$BASE/config"
```

***

## Symbol metrics

```bash theme={null}
GET /v1/metrics?symbol=BTC-USD
```

Per-symbol engine metrics.

```bash theme={null}
curl "$BASE/metrics?symbol=BTC-USD"
```

<ResponseField name="open_interest" type="number">
  Total open interest for the symbol.
</ResponseField>

<ResponseField name="recent_volume" type="number">
  Trading volume over the recent window.
</ResponseField>

<ResponseField name="last_funding_rate" type="number">
  Most recent funding rate.
</ResponseField>