# Crypto Quote

> Returns real-time cryptocurrency quote with price, change, volume, and market cap.

`GET https://api.bavest.co/v2/crypto/quote`

Group: Crypto. Route id: `v2_crypto_quote`. Included in: Growth.

## Authentication

Send your API key in the `x-api-key` header on every request. No key yet? Sign up at https://dashboard.bavest.co/sign-up (free trial). The examples read the key from the `BAVEST_API_KEY` environment variable.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `symbol` | query | string | yes | Cryptocurrency pair symbol (e.g., `BTCUSD`, `ETHUSD`, `SOLUSD`). Example `BTCUSD`. |

## Response

200 Successful response (`application/json`).

| Field | Type | Always present | Description |
|---|---|---|---|
| `data` | object | no |  |
| `data.symbol` | string | no | Cryptocurrency pair symbol. Example: `BTCUSD`. |
| `data.name` | string | no | Cryptocurrency name. Example: `Bitcoin USD`. |
| `data.price` | number | no | Current price. Example: `67542.31`. |
| `data.change` | number | no | Absolute price change. Example: `-1250.5`. |
| `data.changePercent` | number | no | Price change percentage. Example: `-1.82`. |
| `data.dayLow` | number | no | Intraday low. Example: `66800`. |
| `data.dayHigh` | number | no | Intraday high. Example: `68900`. |
| `data.open` | number | no | Opening price. Example: `68792.81`. |
| `data.previousClose` | number | no | Previous close price. Example: `68792.81`. |
| `data.volume` | number | no | 24h trading volume. Example: `28453120000`. |
| `data.marketCap` | number \| null | no | Market capitalization. Example: `1329000000000`. |
| `data.timestamp` | integer | no | Quote timestamp (Unix epoch seconds) Example: `1773352065`. |
| `meta` | ResponseMeta | no | Response envelope metadata. Always present on a 200: `time` is set by `core/response.py` on every successful response. Errors carry the same block, built by the same code, so a client parses one meta shape whether the call succeeded or failed. |
| `meta.time` | integer | no | Server-side processing time in milliseconds. Example: `17`. |
| `meta.parameters` | object | no | Echo of the request parameters the endpoint resolved. |

## Example request

```bash
curl 'https://api.bavest.co/v2/crypto/quote?symbol=BTCUSD' \
  -H "x-api-key: $BAVEST_API_KEY"
```

## Example response

```json
{
  "data": {
    "symbol": "BTCUSD",
    "name": "Bitcoin USD",
    "price": 86756.99,
    "change": 1907.06,
    "changePercent": 2.2476,
    "dayLow": 84555.46,
    "dayHigh": 87209,
    "open": 84849.93,
    "previousClose": 84849.93,
    "volume": 41500573696,
    "marketCap": 1732761790904,
    "timestamp": 1790949957
  },
  "meta": {
    "parameters": {
      "symbol": "BTCUSD"
    },
    "time": 8
  }
}
```

## Errors

| Status | Meaning |
|---|---|
| 400 | Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive). |
| 401 | Missing or invalid API key. |
| 404 | Resource not found. |
| 429 | Rate limit exceeded. Retry after the `Retry-After` header interval. |
| 500 | An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value. |
| 502 | Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay. |
| 504 | The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load. |
| default | An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value. |

- `403` from the gateway: the API key is invalid or switched off.
- `429` with message `Limit Exceeded`: the monthly quota of the key is used up. With `Too Many Requests`: the key is throttled, or this route is not in the key's plan. Wait for `Retry-After` when it is sent.

## Links

- HTML page: https://dashboard.bavest.co/docs/v2_crypto_quote
- OpenAPI: https://dashboard.bavest.co/openapi.json (YAML: https://dashboard.bavest.co/openapi.yaml)
- Authentication: https://dashboard.bavest.co/docs/authentication.md
- MCP server for AI agents: https://dashboard.bavest.co/docs/mcp.md
- All routes: https://dashboard.bavest.co/llms.txt