---
title: "Retrieve Depth of Book"
method: POST
path: "/quotes/depth"
tags: ["Depth of Book"]
---

# Retrieve Depth of Book

`POST /quotes/depth`

Get the Depth of Book for an Instrument.

For now, this API only works with debt instruments, but will expand in the future.

## Request body

- MarketQuoteRequest — Trade Quote Request for Fixed Income Securities
  - `instrumentID` string, uuid, required — A unique ID created by DriveWealth to identify a specific instrument.
  - `quantity` number, double, required — The quantity of bonds user wishes to trade.
  - `salesCredit` SalesCredit — If set, the unit price will be marked up or marked down based on the prescribed amount. Only applicable to Orders for Debt Instruments.
    - `currency` 'USD' — The name of the currency in abbreviation form.
    - `amount` integer — The sales credit amount in cents.

## Response `200`

Fetching Market data was successful

- MarketQuoteResponse — Trade Quote Response for Fixed Income Orders
  - `id` string, uuid — Quote id in the DriveWealth System
  - `instrumentID` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
  - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.
  - `CUSIP` string — CUSIP stands for `Committee on Uniform Securities Identification Procedures`. A CUSIP number identifies most financial instruments, including: stocks of all registered U.S. and Canadian companies, commercial paper, and U.S. government and municipal bonds. The CUSIP system facilitates the clearance and settlement process of securities. CUSIP numbers consist of nine characters (including letters and numbers) that uniquely identify a company or issuer and the type of financial instrument. A similar system is used to identify foreign securities (`CUSIP International Numbering System or CINS`). CINS employs the same nine character identifier as CUSIP, but also contains a letter in the first position to signify the issuer's country or geographic region.
  - `quantity` number, double — Trade size/quantity
  - `salesCredit` SalesCredit — If set, the unit price will be marked up or marked down based on the prescribed amount. Only applicable to Orders for Debt Instruments.
    - `currency` 'USD' — The name of the currency in abbreviation form.
    - `amount` integer — The sales credit amount in cents.
  - `bidPrices` BidPrice[] — bid prices without sales credit
    - `bidPrice` number, double — Bid value
    - `bidSize` number, double — Bid size
    - `bidYield` number, double — Bid yield
    - `minQty` number, double — Minimum quantity
  - `askPrices` AskPrice[] — ask prices without sales credit
    - `askPrice` number, double — Ask value
    - `askSize` number, double — Ask size
    - `askYield` number, double — Ask yield
    - `minQty` number, double — Minimum quantity
  - `effectiveBidPrices` BidPrice[] — prices include any sales credit provided in the request
    - `bidPrice` number, double — Bid value
    - `bidSize` number, double — Bid size
    - `bidYield` number, double — Bid yield
    - `minQty` number, double — Minimum quantity
  - `effectiveAskPrices` AskPrice[] — prices include any sales credit provided in the request
    - `askPrice` number, double — Ask value
    - `askSize` number, double — Ask size
    - `askYield` number, double — Ask yield
    - `minQty` number, double — Minimum quantity
  - `recentTrades` RecentTrade[] — Recent Trades
    - `price` number, double — Trade price
    - `quantity` number, double — Trade size/quantity
    - `yield` number, double — Trade yield
    - `date` string, date-time — Asset's trade time.
    - `side` 'buy' | 'sell' — The side of order that is being placed.

---

[API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/revisions/9fced6d0ac41/schema)