---
title: "GET /v2/mobile/spot-catalogue/candles"
method: GET
path: "/v2/mobile/spot-catalogue/candles"
tags: ["Mobile Spot"]
---

# GET /v2/mobile/spot-catalogue/candles

`GET /v2/mobile/spot-catalogue/candles`

## Request

- Base URL: `https://api.peer.xyz`
- URL: `https://api.peer.xyz/v2/mobile/spot-catalogue/candles`
- Auth: none declared

## Query parameters

- `chainId` integer, required
- `address` string, required
- `interval` '1m' | '5m' | '15m' | '1h' | '4h' | '1d', required

## Response `200`

Spot candles retrieved

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` object
    - `interval` '1m' | '5m' | '15m' | '1h' | '4h' | '1d', required
    - `candles` object[], required
      - `t` integer, required
      - `o` number, required
      - `h` number, required
      - `l` number, required
      - `c` number, required
    - `budgetExceeded` boolean, required
  - `statusCode` number, required
  - `errorCode` string

## Other responses

- `400`: Invalid spot request
- `429`: Too many spot requests (Retry-After)
- `502`: CoinGecko failed
- `503`: CoinGecko key not configured, the read still loading, or the rate limiter unavailable (Retry-After)

## Changes

- **2026-10-05** `0954abd75f80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peer/apis/swagger-api/changes/v2/mobile/spot-catalogue/candles/get.md)

---

[API](https://skmtc.dev/peer/apis/swagger-api.md) - [All operations](https://skmtc.dev/peer/apis/swagger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peer/apis/swagger-api/revisions/ef91955315e2?raw)