# BrokerMeta API reference (preview)

> Base URL, authentication, endpoints, query parameters, response shape and error codes

Source: https://brokermeta.ai/docs

---

Endpoint paths, parameter names and field names are indicative while the API is in early access.
Full reference documentation goes to early-access partners with their keys.

## Base URL and auth

```
https://api.brokermeta.ai/v1
Authorization: Bearer <your-api-key>
```

## Endpoints

| Method | Path | Returns |
| --- | --- | --- |
| GET | `/brokers` | Brokers, filtered by country, client type or asset class |
| GET | `/brokers/{broker}` | A broker with its legal entities and licences |
| GET | `/brokers/{broker}/offerings` | What the broker offers a client type in a jurisdiction |
| GET | `/brokers/{broker}/changes` | Version history, with previous values and effective dates |
| GET | `/schema` | Machine-readable field reference for the current schema version |

## Query parameters

`country` (iso_3166_1), `client_type` (retail | professional), `fields` (string[]),
`as_of` (date), `version` (integer).

## Example

```
GET /brokers/example-broker/offerings?country=AE&client_type=retail
```

```json
{
  "broker": "example-broker",
  "legal_entity": "Example Broker (UAE) Ltd",
  "licence": "ABC123",
  "client_type": "retail",
  "country": "AE",
  "offering": {
    "average_spread": 0.7,
    "minimum_deposit": 0,
    "max_leverage": "1:200",
    "instruments": 980
  },
  "updated_at": "2026-08-31T09:14:00Z"
}
```

## Errors

`400` invalid parameter or unknown field · `401` missing or invalid API key ·
`403` key not provisioned for the resource · `404` no match · `429` rate exceeded.

## Versioning

Every record carries a version number and an effective date. Previous values stay retrievable via
the changes endpoint, `as_of` reconstructs what a page should have said on a given date, and
schema versions are namespaced in the URL.

---

## About this file

Markdown version of https://brokermeta.ai/docs, provided under the [llms.txt](https://llmstxt.org)
proposal. The index of every such file is at https://brokermeta.ai/llms.txt.

Every broker value in BrokerMeta material is an illustrative example for a fictional
"Example Broker". No real broker is described, and nothing here is financial advice.

Questions: hello@brokermeta.ai