---
title: "Retrieve traded volumes by market ids."
method: GET
path: "/v3/markets/{market_ids}/volumes/"
tags: ["volumes"]
---

# Retrieve traded volumes by market ids.

`GET /v3/markets/{market_ids}/volumes/`

## Request

- Base URL: `https://api.smarkets.com`
- URL: `https://api.smarkets.com/v3/markets/{market_ids}/volumes/`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/smarkets/apis/smarkets-http-api/docs/v3/markets/:market_ids/volumes/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `market_ids` integer[], required

## Response `200`

Volumes success response

- object: Volumes success response
  - `volumes` object[], required
    - `double_stake_volume` integer, required: This is the traded volume measured in GBP, but calculated in a different way.<br> It is the twice back stake for every execution.
    - `market_id` string, required: This ID uniquely identifies the market
    - `volume` integer, required: This is the traded volume measured in GBP.<br> It is the sum of back stake (on the back side) with liability (on the lay side)<br> This is the volume displayed in our website.

## Other responses

- `400`: REQUEST_VALIDATION_ERROR, BAD_REQUEST
- `401`: AUTH_REQUIRED
- `403`: FORBIDDEN
- `414`: REQUEST_TOO_LARGE
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: MDS_SERVICE_UNAVAILABLE, EVENTS_INTERNAL_ERROR, EVENTS_API_RATE_LIMIT, EVENTS_UNAVAILABLE

## Changes

> 21 revisions in range; 1 not diffed.

- **2022-10-22** `a17ca5bb986a`: 1 warning
  - added the new `BAD_REQUEST` enum value to the `error_type` response property for the response status `400`
- **2022-02-06** `032833ac8ca3`: 3 breaking, 4 info
  - the response's body type changed from `object` to no type for status `400`
  - the `data` response's property type changed from `null` to `object` for status `500`
  - the `data` response's property type changed from `string` to `string, object` for status `400`
  - added the non-success response with the status `401`
  - …3 more

[Operation history](https://skmtc.dev/smarkets/apis/smarkets-http-api/changes/v3/markets/:market_ids/volumes/get.md)

---

[API](https://skmtc.dev/smarkets/apis/smarkets-http-api.md) - [All operations](https://skmtc.dev/smarkets/apis/smarkets-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smarkets/apis/smarkets-http-api/revisions/32c5f1f4369e?raw)