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

# Troubleshooting

> Common issues when calling Vero Data Hub API

<div style={{ width: '100%', height: 240, marginBottom: 32, borderRadius: 16, overflow: 'hidden', position: 'relative' }}>
  <video style={{ width: '100%', height: '100%', objectFit: 'cover', filter: 'sepia(0.3) saturate(1.5) hue-rotate(-14deg) brightness(0.72) contrast(1.12)' }} autoPlay loop muted playsInline>
    <source src="https://mintcdn.com/vero-fa5575b5/G_sL_RHXpWEXOwUp/images/bg_video.mp4?fit=max&auto=format&n=G_sL_RHXpWEXOwUp&q=85&s=f731a6a676fb99a2368193fbaf3281ee" type="video/mp4" data-path="images/bg_video.mp4" />
  </video>
</div>

<div style={{ width: '100%', height: 4, marginBottom: 24, borderRadius: 2, background: 'rgba(0,0,0,0.08)' }}>
  <div style={{ width: '100%', height: '100%', borderRadius: 2, background: 'linear-gradient(90deg, var(--accent-primary) 0%, var(--accent-light) 50%, var(--accent-dark) 100%)' }} />
</div>

## Quick checklist

<Steps>
  <Step title="Check method and path">
    Compare your request against the endpoint page in the API reference.
  </Step>

  <Step title="Check credentials">
    For `401`, verify the API key assigned to your account.
  </Step>

  <Step title="Check time format">
    Use ISO 8601 UTC timestamps with a `Z` suffix for `from` and `to`.
  </Step>

  <Step title="Check response status">
    Use the response tabs in the playground to inspect each status code.
  </Step>
</Steps>

## Common errors

| Symptom                       | Common cause                                           | Fix                                                    |
| ----------------------------- | ------------------------------------------------------ | ------------------------------------------------------ |
| `400 Invalid query parameter` | Missing required parameter or invalid time format      | Check required params and use UTC `Z` timestamps       |
| `401 Unauthorized`            | Missing or invalid credential                          | Check your API key                                     |
| `404 Not found`               | Symbol, fund code, report ID or news ID does not exist | Use a list endpoint to find the correct value          |
| `422 Unprocessable`           | Correct format but unsupported value                   | Check enum values such as resolution or statement type |
| `429 Too many requests`       | Request limit exceeded                                 | Reduce request rate and retry later                    |
| `503 Unavailable`             | API temporarily unavailable                            | Retry with backoff                                     |

## Time format examples

| Valid                      | Invalid                     |
| -------------------------- | --------------------------- |
| `2026-05-15T00:00:00Z`     | `2026-05-15 00:00:00`       |
| `2026-05-15T00:00:00.123Z` | `2026-05-15T07:00:00+07:00` |

## Information to include when asking for support

| Information   | Example                                        |
| ------------- | ---------------------------------------------- |
| Endpoint      | `GET /v1/candles`                              |
| Query params  | `symbol=BTCUSDT&resolution=5m&from=...&to=...` |
| HTTP status   | `400`, `401`, `404`, `429`, `503`              |
| Response body | JSON response or error body                    |
| Request time  | UTC timestamp                                  |