> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Bond prices
>
This endpoint is in **Beta**. Access must be requested before you can use it: contact [support@bigdata.com](mailto:support@bigdata.com) to join the Beta program.
Returns the latest price and yield of bonds by the bonds' ISINs, one or up to 50 per
request, with each bond's spread over the government bond set as its benchmark when
it was issued. `results` is keyed by ISIN, one key per distinct ISIN sent in the order
sent. The price fields are present only for a priced bond, so a bond with no price,
known or not, is an empty object or names only its `benchmark`; the spread is present
only when the bond and its benchmark were both priced on the same date.
## OpenAPI
````yaml /api-rest/openapi/openapi_structured_data.json post /v1/fixed-income/corporate/prices/query
openapi: 3.1.0
info:
title: Bigdata Structured Data API
description: Bigdata API documentation
version: 1.0.0
servers:
- url: https://api.bigdata.com/
security:
- ApiKeyAuth: []
tags:
- name: Market Data
description: >-
Market data endpoints including intraday prices, daily prices, price
changes, and real-time quotes
- name: Analyst Estimates
description: >-
Analyst estimates and ratings including analyst ratings, estimates, target
prices, and earnings surprises
- name: Financials & Ratios
description: >-
Financial statements and ratios including balance sheet, income statement,
cash flow statement, key metrics TTM, and company ratios TTM
- name: Company & Events
description: >-
Company information and events including company profile and events
calendar
- name: Fund Holdings
description: >-
Institutional fund holdings from SEC 13F filings including fund holdings
and stock fund holdings
- name: Knowledge Graph
description: Corporate ownership and hierarchy data.
- name: Private Markets
description: >-
Private company data including profile, headquarters, funding totals and
valuation
- name: Fixed Income
description: 'Bond reference data: the bonds a company has issued and their terms'
paths:
/v1/fixed-income/corporate/prices/query:
post:
tags:
- Fixed Income
summary: Bond prices
description: >-
This endpoint is in **Beta**. Access must be requested before you can
use it: contact [support@bigdata.com](mailto:support@bigdata.com) to
join the Beta program.
Returns the latest price and yield of bonds by the bonds' ISINs, one or
up to 50 per
request, with each bond's spread over the government bond set as its
benchmark when
it was issued. `results` is keyed by ISIN, one key per distinct ISIN
sent in the order
sent. The price fields are present only for a priced bond, so a bond
with no price,
known or not, is an empty object or names only its `benchmark`; the
spread is present
only when the bond and its benchmark were both priced on the same date.
operationId: query_bond_prices_v1_fixed_income_corporate_prices_query__post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BondPricesQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BondPricesResponse'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestError'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequestsError'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
components:
schemas:
BondPricesQuery:
properties:
identifier:
$ref: '#/components/schemas/IsinIdentifier'
description: The bonds to price, named by their ISINs.
additionalProperties: false
type: object
required:
- identifier
title: BondPricesQuery
example:
identifier:
type: isin
value:
- US04621WAE03
- USU49454AJ75
BondPricesResponse:
properties:
results:
additionalProperties:
$ref: '#/components/schemas/BondPriceSnapshot'
type: object
title: Results
description: >-
The snapshots keyed by ISIN: one key per distinct ISIN sent,
upper-cased, in the order they were sent. A bond with no price is an
empty object, or names only its benchmark.
examples:
- US04621WAE03:
as_of_date: '2026-10-27'
benchmark:
as_of_date: '2026-10-27'
isin: US912810SX72
yield: 5.4062
price: 64.772
spread_bp: 105.94
yield: 6.4657
USU0378GAQ83: {}
errors:
anyOf:
- items:
$ref: '#/components/schemas/ErrorDetail'
type: array
- type: 'null'
title: Errors
metadata:
anyOf:
- $ref: '#/components/schemas/StructuredDataMetadata'
- type: 'null'
sources:
anyOf:
- items:
$ref: '#/components/schemas/Source'
type: array
- type: 'null'
title: Sources
description: >-
Structured-data sources the response was built from, one entry per
source. Empty when no catalog source contributed.
usage:
anyOf:
- $ref: '#/components/schemas/Usage'
- type: 'null'
description: >-
Tokens the request consumed, per content tier. Returned only to
callers billed in tokens.
type: object
required:
- results
title: BondPricesResponse
BadRequestError:
properties:
statusCode:
type: integer
const: 400
title: Statuscode
default: 400
message:
type: string
title: Message
type: object
required:
- message
title: BadRequestError
description: Bad Request Error
example:
message: Bad Request Error
statusCode: 400
TooManyRequestsError:
properties:
statusCode:
type: integer
const: 429
title: Statuscode
default: 429
message:
type: string
title: Message
type: object
required:
- message
title: TooManyRequestsError
description: Too many requests. Please try again later.
example:
message: Too many requests. Please try again later.
statusCode: 429
InternalServerError:
properties:
statusCode:
type: integer
const: 500
title: Statuscode
default: 500
message:
type: string
title: Message
type: object
required:
- message
title: InternalServerError
description: Internal Server Error
example:
message: Internal Server Error
statusCode: 500
IsinIdentifier:
properties:
type:
$ref: '#/components/schemas/IsinIdentifierTypeEnum'
description: The identifier the bonds are named by. Only `isin` is accepted.
examples:
- isin
value:
anyOf:
- type: string
description: >-
ISIN (International Securities Identification Number) of the
bond: two letters, nine letters or digits and a check digit.
Case and surrounding spaces are ignored. Example: `US037833EQ92`
examples:
- US037833EQ92
- items:
type: string
description: >-
ISIN (International Securities Identification Number) of the
bond: two letters, nine letters or digits and a check digit.
Case and surrounding spaces are ignored. Example:
`US037833EQ92`
examples:
- US037833EQ92
type: array
title: Value
description: One ISIN, or a list of 1 to 50. An ISIN sent twice is answered once.
type: object
required:
- type
- value
title: IsinIdentifier
BondPriceSnapshot:
properties:
price:
anyOf:
- type: number
- type: 'null'
title: Price
description: >-
Latest price as a percentage of face value (98.5 means 98.5% of
par). Absent when there is no price for the bond, whether or not the
ISIN is a known bond.
examples:
- 64.772
yield:
anyOf:
- type: number
- type: 'null'
title: Yield
description: Yield at `price`, in percent (6.47 means 6.47%).
examples:
- 6.4657
as_of_date:
anyOf:
- type: string
format: date
- type: 'null'
title: As Of Date
description: Date of `price` and `yield`.
examples:
- '2026-10-27'
benchmark:
anyOf:
- $ref: '#/components/schemas/BondBenchmark'
- type: 'null'
description: The bond's benchmark. Absent when the bond has none.
spread_bp:
anyOf:
- type: number
- type: 'null'
title: Spread Bp
description: >-
`yield` minus the benchmark's `yield`, in basis points (100 basis
points is 1%). Present only when both yields are available and are
for the same date.
examples:
- 105.94
type: object
title: BondPriceSnapshot
description: A bond's latest price and yield, and its spread over its benchmark.
ErrorDetail:
properties:
message:
anyOf:
- type: string
- type: 'null'
title: Message
type: object
title: ErrorDetail
StructuredDataMetadata:
properties:
request_id:
anyOf:
- type: string
- type: 'null'
title: Request Id
timestamp:
type: string
title: Timestamp
type: object
title: StructuredDataMetadata
Source:
properties:
id:
type: string
title: Id
description: Content catalog identifier of the source.
examples:
- CA9FA3
name:
type: string
title: Name
description: Catalog name of the dataset the data came from.
examples:
- Corporate Fundamentals
type: object
required:
- id
- name
title: Source
description: >-
A content catalog source that contributed data to a structured-data
response.
Usage:
additionalProperties:
type: integer
type: object
title: Usage
description: >-
Public structured-data usage for a request, aggregated per content tier.
A flat object keyed per content tier, where each key is derived from the
content tier identifier by dropping the ``content-`` prefix and
appending
``_tokens`` (e.g. ``corporate-fundamentals`` ->
``corporate_fundamentals_tokens``). It is sparse: only tiers with
non-zero
tokens appear, and an absent key means zero tokens for that tier.
IsinIdentifierTypeEnum:
type: string
enum:
- isin
title: IsinIdentifierTypeEnum
BondBenchmark:
properties:
isin:
type: string
title: Isin
description: >-
ISIN of the government bond set as the bond's benchmark when it was
issued. It does not move to a newer government bond later.
examples:
- US912810SX72
yield:
anyOf:
- type: number
- type: 'null'
title: Yield
description: >-
Latest yield of the benchmark, in percent. Absent when the bond has
no price or the benchmark has no price.
examples:
- 5.4062
as_of_date:
anyOf:
- type: string
format: date
- type: 'null'
title: As Of Date
description: Date of `yield`.
examples:
- '2026-10-27'
type: object
required:
- isin
title: BondBenchmark
description: The government bond a bond's spread is measured against.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-KEY
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.