---
title: "Retrieve prices"
method: GET
path: "/prices"
tags: ["market-data"]
---

# Retrieve prices

`GET /prices`

Retrieve the price for the requested symbols as-of the given datetime, which defaults to now.

## Query parameters

- `symbol` string[], required — Return prices for the given symbols.
- `asof` string, date-time — Return prices as-of the given datetime. Defaults to now.

## Response `200`

OK

- Price[]
  - `accrued_interest` string, nullable, required — Accrued interest at standard settlement, in the same units as bid/ask (% of par). Populated only for fixed-coupon bonds.
  - `ask` string, required — The ask (sell) price at the specific point in time.
  - `bid` string, required — The bid (buy) price at the specific point in time.
  - `currency` 'EUR' | 'USD' | 'GBP', required
  - `dirty_ask` string, nullable — Gross (dirty) ask for fixed-income instruments: full settlement cash price including accrued interest, in the same units as ask. Set when the vendor publishes dirty quotes alongside clean bid/ask/mid; otherwise null.
  - `dirty_bid` string, nullable — Gross (dirty) bid for fixed-income instruments: full settlement cash price including accrued interest, in the same units as bid (typically % of par). Set when the vendor publishes dirty quotes alongside clean bid/ask/mid; otherwise null.
  - `dirty_mid` string, nullable — Gross (dirty) mid derived from dirty bid and ask (or supplied by the vendor), in the same units as mid. Null when dirty sides are not available.
  - `mid` string, nullable, required — The mid-price (bid + ask / 2).
  - `price_type` 'percent' | 'money', required
  - `quality` 'closing' | 'intraday' | 'realtime' | 'delayed', required
  - `symbol` string, required — The instrument symbol i.e ISIN or ticker.
  - `timestamp` string, date-time, required — [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) datetime of when the price was in effect.
  - `ytm_ask` string, nullable, required — The ask yield-to-maturity at the specific point in time. Only applicable for fixed-income instrument types like bonds and bills.
  - `ytm_bid` string, nullable, required — The bid yield-to-maturity at the specific point in time. Only applicable for fixed-income instrument types like bonds and bills.
  - `ytm_mid` string, nullable, required — The mid yield-to-maturity (bid + ask / 2) at the specific point in time. Only applicable for fixed-income instrument types like bonds and bills.

## Other responses

- `400` — Bad Request

## Changes

- **2026-07-13** `03da9bc8e86b` — 1 info
  - api tag `market-data` added

[Change history](https://skmtc.dev/joinsophic/apis/sophic-engine-api/changes/prices/get.md)

---

[API](https://skmtc.dev/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.dev/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/revisions/03da9bc8e86b/schema)