---
title: "Estimate price"
method: POST
path: "/trading/prices"
tags: ["Prices"]
---

# Estimate price

`POST /trading/prices`

## Request

- Base URL: `https://api.enterprise.sandbox.uphold.com`
- URL: `https://api.enterprise.sandbox.uphold.com/trading/prices`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/core/oauth2/token` scopes: `trading.prices:read`
- TypeScript: <https://skmtc.dev/uphold/apis/trading-api/docs/trading/prices/post.ts> (a function with typed inputs; its response is checked against the schema)

Estimate the volume-weighted price to buy or sell a quantity of an asset. The estimate is nonbinding and does not create an order or reserve funds.

## Headers

- `X-On-Behalf-Of` string
- `X-Uphold-User-Ip` union
  - string, ipv4
  - string, ipv6
- `X-Uphold-User-Agent` string
- `X-Uphold-User-Origin` string
- `X-Uphold-User-Country` string
- `X-Uphold-User-Subdivision` string
- `X-Uphold-User-City` string

## Request body

- object
  - `base` string, required: The base asset, the one bought or sold.
  - `quote` string, required: The quote asset, the one the price is expressed in.
  - `side` 'buy' | 'sell', required: Whether the base asset is bought or sold.
  - `quantity` string, required: The quantity of the base asset to estimate the price of.

## Response `200`

Price estimated.

- object
  - `price` string, required: The estimated volume-weighted execution price, in the quote asset per one unit of the base asset.
  - `snapshotAt` string, date-time, required: The time of the order book snapshot the price was calculated from. It is not the time of the request or of the calculation.

## Other responses

- `400`: Bad Request.
- `401`: Unauthorized.
- `403`: Forbidden.
- `409`: Business logic error.
- `429`: Too Many Requests.
- `503`: The venue is unavailable.

---

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