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

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

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

## Request

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

## Query parameters

- `freshness` 'catalogue' | 'detail'
- `tokens` string, required: Up to 30 comma-separated chainId:address keys on chains Peer trades, e.g. 8453:0x532f27101965dd16442e59d40670faf5ebb142e4,792703809:DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

## Response `200`

Spot metrics retrieved

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` object
    - `assets` object, required
    - `budgetExceeded` boolean, required
  - `statusCode` number, required
  - `errorCode` string

## Other responses

- `400`: Invalid spot request
- `429`: Too many spot requests (Retry-After)
- `503`: Rate limiter unavailable (Retry-After)

## Changes

- **2026-10-13** `85a872974b35`: 1 info
  - added the required property `responseObject/assets/additionalProperties/metrics/fdvUsd` to the response with the `200` status
- **2026-10-09** `08a4a05166f7`: 1 info
  - added the new optional `query` request parameter `freshness`
- **2026-10-05** `0954abd75f80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peer/apis/swagger-api/changes/v2/mobile/spot-catalogue/metrics/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)