> ## Documentation Index > Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt > Use this file to discover all available pages before exploring further. # List bonds in yield-curve maturity buckets. > Use this operation to inspect which bonds are eligible for each configured maturity bucket of requested issuer yield curves on one date. Curve identifiers combine issuer, ISO currency, and debt seniority. Bucket keys are returned as day tenors such as `365d`, with eligible bonds identified by ISIN when available and otherwise by FIGI. Results can be partial when an issuer, curve configuration, bucket definition, or eligible bond set is unavailable. ## OpenAPI ````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/MarketData/GetBondYieldCurveMaturityBuckets openapi: 3.0.4 info: title: Derivitec Api 1.0 version: '1.0' servers: - url: https://api.riskportal.activeviam.com security: - oauth2: [] - apikey: [] tags: - name: AdminUser - name: AtotiReport - name: AtotiSession - name: BloombergOAuth - name: Bond - name: BondYieldCurvePage - name: BookAccess - name: Books - name: Commodity - name: Counterparties - name: Currencies - name: Equity - name: EquityDividend - name: EquityPage - name: FeatureFlag - name: Fx - name: FxPage - name: GroupAccess - name: Home - name: LegacyPosition - name: MarketData - name: MarketDataProvider - name: MarketDataProviderAccess - name: Meta - name: Notification - name: Organisation - name: PnLReport - name: PortfolioAccess - name: Portfolios - name: Position - name: PositionFilter - name: PricingEnvironment - name: PricingEnvironmentAccess - name: RateAsset - name: RateAssetPage - name: Report - name: ReportDefinition - name: ReportHistoryLauncherQuery - name: ReportLauncher - name: ReportQuery - name: ReportQueryViewUser - name: ReportRestriction - name: ReportView - name: RiskReport - name: Tradable - name: TradeBooking - name: User - name: VarReport - name: VarReportQuery - name: YieldCurvePage paths: /api/MarketData/GetBondYieldCurveMaturityBuckets: post: tags: - MarketData summary: List bonds in yield-curve maturity buckets. description: >- Use this operation to inspect which bonds are eligible for each configured maturity bucket of requested issuer yield curves on one date. Curve identifiers combine issuer, ISO currency, and debt seniority. Bucket keys are returned as day tenors such as `365d`, with eligible bonds identified by ISIN when available and otherwise by FIGI. Results can be partial when an issuer, curve configuration, bucket definition, or eligible bond set is unavailable. operationId: GetBondYieldCurveMaturityBuckets requestBody: description: >- The query payload. `BondYieldCurveIds` must be non-empty, `MarketDate` is interpreted as a date only, and provider or environment fields select the authorised source scope. content: application/json-patch+json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesMaturityBucketsRequest' application/json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesMaturityBucketsRequest' text/json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesMaturityBucketsRequest' application/*+json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesMaturityBucketsRequest' responses: '200': description: >- Returns maturity-bucket day tenors and bond identifiers by requested curve, together with unknown-issuer, missing-configuration, missing-bucket, or missing-bond errors. content: application/json: schema: $ref: >- #/components/schemas/ApiGetBondYieldCurveMaturityBucketsResponse '400': description: BadRequest '401': description: Unauthorized '403': description: Forbidden security: - oauth2: [] - apikey: [] components: schemas: ApiGetBondYieldCurvesMaturityBucketsRequest: required: - $type type: object properties: market_data_environment_name: type: string description: >- Name of the market-data environment to use. Supply either this name or `provider_id`, not both. nullable: true example: Example market data provider_id: type: string description: >- Opaque identifier of the market-data provider to use. Supply either this identifier or `market_data_environment_name`, not both. nullable: true bond_yield_curve_ids: type: array items: $ref: '#/components/schemas/BondYieldCurveId' description: >- Bond yield curve IDs selecting the requested bond yield curves maturity buckets. nullable: true market_date: type: string description: >- Market date on which bond yield curves maturity buckets are requested. format: date-time $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetBondYieldCurvesMaturityBucketsRequest, Derivitec.Web.Core additionalProperties: false description: >- Queries maturity buckets for selected bond yield curves on a market date. ApiGetBondYieldCurveMaturityBucketsResponse: required: - $type type: object properties: is_success: type: boolean description: >- Whether the operation completed successfully. The default is `true`; error outcomes set it to `false`. example: true error_messages: type: array items: type: string description: >- Messages explaining operation-level failures. The collection is empty by default. nullable: true bond_yield_curve_maturity_buckets: type: array items: $ref: >- #/components/schemas/BondYieldCurveIdStringInstrumentIdentifierListDictionaryKeyValuePair description: Maturity buckets keyed by bond yield-curve identifier. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetBondYieldCurveMaturityBucketsResponse, Derivitec.Web.Core additionalProperties: false description: Returns maturity buckets grouped by bond yield curve. BondYieldCurveId: required: - $type type: object properties: currency: type: string description: Currency component of the curve key. nullable: true issuer: type: string description: Issuer component of the curve key. nullable: true seniority: enum: - senior - super_senior - other - subordinated - junior_subordinated - preference_shares - senior_loss_absorbing type: string description: Contract or debt seniority classification. bond_identifier: $ref: '#/components/schemas/InstrumentIdentifier' $type: type: string enum: - Derivitec.Web.Core.MarketData.BondYieldCurveId, Derivitec.Web.Core additionalProperties: false description: Business key for an issuer bond curve. BondYieldCurveIdStringInstrumentIdentifierListDictionaryKeyValuePair: type: object properties: key: $ref: '#/components/schemas/BondYieldCurveId' value: type: object additionalProperties: type: array items: $ref: '#/components/schemas/InstrumentIdentifier' additionalProperties: false InstrumentIdentifier: description: >- Instrument code qualified by an identifier namespace and optional market code. discriminator: propertyName: $type mapping: Derivitec.Web.Core.MarketData.InstrumentIdentifier, Derivitec.Web.Core: '#/components/schemas/InstrumentIdentifierMintlifyShape' Derivitec.Web.Core.MarketData.InstrumentInfo, Derivitec.Web.Core: '#/components/schemas/InstrumentInfo' oneOf: - $ref: '#/components/schemas/InstrumentIdentifierMintlifyShape' - $ref: '#/components/schemas/InstrumentInfo' InstrumentIdentifierMintlifyShape: required: - $type type: object properties: code: type: string description: Instrument code interpreted in the selected identifier namespace. nullable: true identifier_type: enum: - Derivitec - Ric - Bloomberg - Isin - Figi - Sedol - RedCode - RedPairCode - BloombergYellow - XIgniteCode - CBondsId - EdiSecId - EdiSymbol - Cusip - NotSet type: string description: Namespace that determines how the instrument code is interpreted. market_identification_code: type: string description: >- Optional market identification code that further qualifies the instrument code. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.InstrumentIdentifier, Derivitec.Web.Core additionalProperties: false description: >- Instrument code qualified by an identifier namespace and optional market code. InstrumentInfo: required: - $type type: object properties: code: type: string description: Instrument code interpreted in the selected identifier namespace. nullable: true identifier_type: enum: - Derivitec - Ric - Bloomberg - Isin - Figi - Sedol - RedCode - RedPairCode - BloombergYellow - XIgniteCode - CBondsId - EdiSecId - EdiSymbol - Cusip - NotSet type: string description: Namespace that determines how the instrument code is interpreted. market_identification_code: type: string description: >- Optional market identification code that further qualifies the instrument code. nullable: true name: type: string description: Human-readable name of the identified instrument. nullable: true $type: type: string enum: - Derivitec.Web.Core.MarketData.InstrumentInfo, Derivitec.Web.Core additionalProperties: false description: Instrument identifier with a human-readable instrument name. securitySchemes: oauth2: type: oauth2 description: >- OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header flows: implicit: authorizationUrl: https://auth.riskportal.derivitec.com/oauth2/authorize scopes: {} apikey: type: apiKey description: API-Key requested via the site and provided as a header name: x-api-key in: header ````