# List the symbols an account's broker offers

URL: https://docs.fxapis.com/api-reference/instruments/list-the-symbols-an-accounts-broker-offers

> List the symbols an account's broker offers. Every symbol the account's broker offers it, with its contract specification, as read from the broker when the…

`GET https://api.fxapis.com/v1/accounts/{id}/symbols`

Every symbol the account's broker offers it, with its contract specification, as read from the broker when the account was last online — so it answers while the account is offline. Refreshed each time the account comes online and the list is a day old. `syncedAt` says when.

Returns 409 `SYMBOLS_NOT_SYNCED` for an account that has never been online.

Authentication: `Authorization: Bearer <API key>`.

#### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `search` | query | string | no | Only symbols whose name or description contains this. |
| `tradable` | query | "true" \| "false" | no | Only symbols this account can, or cannot, open positions in. |
| `limit` | query | integer | no |  |
| `cursor` | query | string | no | The `nextCursor` from the previous page. |
| `id` | path | string (uuid) | yes |  |

#### Responses

- `200`
- `400`
- `401`
- `404`
- `409`

Failures return `{ "error": { "code", "message" } }`; every code is listed at https://docs.fxapis.com/errors.

#### 200 response fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object[] | no |  |
| `data[].name` | string | no | The broker's own name, exactly as an order must send it. Example: `"XAUUSD.a"` |
| `data[].description` | string | no | Example: `"Gold vs US Dollar"` |
| `data[].path` | string | no | The broker's folder for it. Example: `"Metals\\XAUUSD.a"` |
| `data[].digits` | null \| integer | no | Example: `2` |
| `data[].contractSize` | null \| number | no | Units of the underlying per 1.0 lot. Example: `100` |
| `data[].volumeMin` | null \| number | no | Example: `0.01` |
| `data[].volumeMax` | null \| number | no | Example: `50` |
| `data[].volumeStep` | null \| number | no | Example: `0.01` |
| `data[].tradable` | boolean | no | Whether this account can open positions in it. |
| `data[].sessions` | null \| object | no | The broker's own sessions, in its server time (see `meta.utcOffsetSeconds`). Null until read. |
| `data[].sessions.trade` | object[] | no | When orders can be placed. |
| `data[].sessions.trade[].day` | "sunday" \| "monday" \| "tuesday" \| "wednesday" \| "thursday" \| "friday" \| "saturday" | no |  |
| `data[].sessions.trade[].open` | string | no | HH:MM. Example: `"00:01"` |
| `data[].sessions.trade[].close` | string | no | HH:MM; `24:00` is the end of the day. Example: `"23:58"` |
| `data[].sessions.quote` | object[] | no | When prices are quoted. |
| `data[].sessions.quote[].day` | "sunday" \| "monday" \| "tuesday" \| "wednesday" \| "thursday" \| "friday" \| "saturday" | no |  |
| `data[].sessions.quote[].open` | string | no | HH:MM. Example: `"00:01"` |
| `data[].sessions.quote[].close` | string | no | HH:MM; `24:00` is the end of the day. Example: `"23:58"` |
| `data[].currencyBase` | string | no |  |
| `data[].currencyProfit` | string | no |  |
| `data[].currencyMargin` | string | no |  |
| `meta` | object | no |  |
| `meta.syncedAt` | string (date-time) | no | When the list was read from the broker. |
| `meta.server` | string | no |  |
| `meta.symbolCount` | integer | no |  |
| `meta.utcOffsetSeconds` | null \| integer | no | The broker's server clock minus UTC, in seconds, measured when the sessions were read. Example: `10800` |
| `meta.sessionsSyncedAt` | null \| string (date-time) | no | When the sessions were read; null until they have been. |
| `page` | object | no |  |
| `page.hasMore` | boolean | no |  |
| `page.nextCursor` | null \| string | no | Pass as `cursor` to continue. |