# Recent ticks (MARKET_DATA)

## API Description

The most recent ticks for a symbol.

> **This is not a tick-history endpoint.** Ticks are served from an in-memory ring buffer that the
> service fills while it is running. It contains only ticks observed **since the service last
> started**, for symbols that are currently being streamed, and it is bounded per symbol. A
> restart empties it. There is no historical tick archive in this API — if you need a tick record,
> capture the [`<SYMBOL>@tick`](/websocket-market-streams/tick-stream.md) stream yourself.

## HTTP Request

```http
GET /v1/ticks
```

## Request Weight

2

## Request Parameters

| Name | Type | Mandatory | Description |
| - | - | - | - |
| `symbol` | STRING | YES | Exact, case-sensitive. |
| `limit` | INT | NO | Default `100`, range `1`–`1000` (`-1130` outside it). Fewer are returned if the buffer holds fewer. |

## Response Example

**Response** — oldest first.

```json
[
  {"symbol":"XAUUSD","bid":"2331.14","ask":"2331.41","last":"2331.14","volume":3,"bidDirection":-1,"askDirection":-1,"time":1789012345601},
  {"symbol":"XAUUSD","bid":"2331.15","ask":"2331.42","last":"2331.15","volume":8,"bidDirection":1,"askDirection":1,"time":1789012345678}
]
```

| Field | Type | Description |
| - | - | - |
| `symbol` | STRING | |
| `bid` / `ask` / `last` | DECIMAL | |
| `volume` | LONG | Tick volume reported with the quote. |
| `bidDirection` / `askDirection` | INT | `1` up, `-1` down, `0` unchanged versus the previous tick. |
| `time` | LONG | Tick time, Unix ms. |

An empty array means the symbol is not currently streamed. Subscribing to `<SYMBOL>@tick` on the
WebSocket starts the feed for that symbol; the buffer fills from that point on.