---
title: "Get Notional Trading Volume"
method: POST
path: "/v1/notionalvolume"
tags: ["Orders"]
---

# Get Notional Trading Volume

`POST /v1/notionalvolume`

## Request

- Base URL: `https://api.gemini.com`
- URL: `https://api.gemini.com/v1/notionalvolume`
- Auth: API key in header `X-GEMINI-APIKEY` and API key in header `X-GEMINI-SIGNATURE` and API key in header `X-GEMINI-PAYLOAD`

### Roles
The API key you use to access this endpoint must have the Trader or Auditor role assigned. See [Roles](/roles#roles) for more information.

The OAuth scope must have `history:read` assigned to access this endpoint. See [OAuth Scopes](/authentication/oauth#oauth-scopes) for more information.

## Headers

- `X-GEMINI-APIKEY` string, required
- `X-GEMINI-SIGNATURE` string, required
- `X-GEMINI-PAYLOAD` string, required
- `Content-Type` string
- `Content-Length` string
- `Cache-Control` string

## Request body

- object
  - `request` string, required: The API endpoint path
  - `nonce` union, required: timestamp
    - string: Gemini strongly recommends using milliseconds instead of seconds for timestamps. | Timestamp format | Example | Supported request type | |-----------------------|-----------------------|------------------------| | string (seconds) | `1495127793` | `POST` only | | string (milliseconds) | `1495127793000` | `POST` only |
    - integer: Gemini strongly recommends using milliseconds instead of seconds for timestamps. | Timestamp format | Example | Supported request type | |-----------------------------|---------------------------|------------------------| | whole number (seconds) | `1495127793` | `GET`, `POST` | | whole number (milliseconds) | `1495127793000` | `GET`, `POST` |
  - `account` string: Required for Master API keys as described in [Private API Invocation](/authentication/api-key#private-api-invocation). The name of the account within the subaccount group. Specifies the account on which you intend to place the order. Only available for exchange accounts.
  - `symbol` string: Optional. The symbol to get fee promotions or specific fee schedule rates for.

## Response `200`

The notional volume

- NotionalVolume
  - `date` string, date
  - `last_updated_ms` integer
  - `web_maker_fee_bps` integer
  - `web_taker_fee_bps` integer
  - `web_auction_fee_bps` integer
  - `api_maker_fee_bps` integer
  - `api_taker_fee_bps` integer
  - `api_auction_fee_bps` integer
  - `fix_maker_fee_bps` integer
  - `fix_taker_fee_bps` integer
  - `fix_auction_fee_bps` integer
  - `notional_30d_volume` string
  - `notional_1d_volume` object[]
    - `date` string: UTC date in `yyyy-MM-dd` format
    - `notional_volume` string, decimal: Notional volume value in USD for this single day
  - `api_notional_30d_volume` string
  - `fee_tier` object
    - `tier` string
    - `api_maker_fee_bps` integer
    - `api_taker_fee_bps` integer

## Other responses

- `400`: Bad request - malformed request or invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `403`: ApiKey fails IP Filtering Check
- `404`: Resource not found
- `429`: Too many requests - you have exceeded the rate limit
- `500`: Internal server error

---

[API](https://skmtc.dev/gemini/apis/rest-api.md) - [All operations](https://skmtc.dev/gemini/apis/rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gemini/apis/rest-api/revisions/24979792d748?raw)