{
  "x402Version": 2,
  "id": 72384,
  "slug": "saylorinnovations-api-finance-bond",
  "resource": "https://saylorinnovations.com/api/finance/bond",
  "description": "Bond price from yield or yield to maturity from price with duration, modified duration, convexity, current yield and the price move for a one point yield change",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "inputs": {
        "type": "object",
        "description": "Inputs used: face value, annual coupon rate, years to maturity and payments per year"
      },
      "yield_to_maturity": {
        "type": "number",
        "description": "Yield to maturity"
      },
      "yield_to_maturity_percent": {
        "type": "number",
        "description": "Yield to maturity, as a percentage"
      },
      "price": {
        "type": "number",
        "description": "Price"
      },
      "price_percent_of_par": {
        "type": "number",
        "description": "Price percent of par"
      },
      "trading": {
        "type": "string",
        "description": "Whether the bond trades at a premium, discount or par"
      },
      "current_yield_percent": {
        "type": "number",
        "description": "Current yield, as a percentage"
      },
      "macaulay_duration_years": {
        "type": "number",
        "description": "Macaulay duration years"
      },
      "modified_duration": {
        "type": "number",
        "description": "Modified duration"
      },
      "convexity": {
        "type": "number",
        "description": "Convexity of the bond"
      },
      "note": {
        "type": "string",
        "description": "Caveat or context for reading the result"
      },
      "source": {
        "type": "string",
        "description": "Data source the values come from"
      },
      "annual_coupon_income": {
        "type": [
          "number",
          "null"
        ],
        "description": "Annual coupon income"
      },
      "price_change_if_yield_rises_1pt_percent": {
        "type": [
          "number",
          "null"
        ],
        "description": "Price change if yield rises 1pt, as a percentage"
      },
      "price_change_if_yield_falls_1pt_percent": {
        "type": [
          "number",
          "null"
        ],
        "description": "Price change if yield falls 1pt, as a percentage"
      },
      "approx_price_move_per_1pt_usd": {
        "type": [
          "number",
          "null"
        ],
        "description": "Approx price move per 1pt, in US dollars"
      }
    },
    "required": [
      "inputs",
      "price",
      "yield_to_maturity"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "coupon": "0.05",
            "freq": "2",
            "years": "10",
            "ytm": "0.045"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "inputs": {
              "face_value": 1000,
              "annual_coupon_rate": 0.05,
              "years_to_maturity": 10,
              "payments_per_year": 2
            },
            "yield_to_maturity": 0.045,
            "yield_to_maturity_percent": 4.5,
            "price": 1039.9093,
            "price_percent_of_par": 103.991,
            "trading": "premium",
            "current_yield_percent": 4.808,
            "annual_coupon_income": 50,
            "macaulay_duration_years": 8.0356,
            "modified_duration": 7.8587,
            "convexity": 74.5506,
            "price_change_if_yield_rises_1pt_percent": -7.486,
            "price_change_if_yield_falls_1pt_percent": 8.231,
            "approx_price_move_per_1pt_usd": -77.847,
            "note": "Plain-vanilla fixed-coupon bond priced at a coupon date (no accrued interest, no call or default risk). Pass ytm to get price and risk measures, or price to solve the yield by bisection.",
            "source": "discounted cash flow"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "coupon": {
                    "type": "string",
                    "description": "Annual coupon rate as decimal (0.05 = 5%)"
                  },
                  "freq": {
                    "type": "string",
                    "description": "optional payments per year 1, 2 (default), 4 or 12"
                  },
                  "years": {
                    "type": "string",
                    "description": "Years to maturity"
                  },
                  "ytm": {
                    "type": "string",
                    "description": "Yield to maturity decimal (to compute price)"
                  }
                },
                "required": [
                  "coupon",
                  "years",
                  "ytm"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "inputs": {
                    "type": "object",
                    "description": "Inputs used: face value, annual coupon rate, years to maturity and payments per year"
                  },
                  "yield_to_maturity": {
                    "type": "number",
                    "description": "Yield to maturity"
                  },
                  "yield_to_maturity_percent": {
                    "type": "number",
                    "description": "Yield to maturity, as a percentage"
                  },
                  "price": {
                    "type": "number",
                    "description": "Price"
                  },
                  "price_percent_of_par": {
                    "type": "number",
                    "description": "Price percent of par"
                  },
                  "trading": {
                    "type": "string",
                    "description": "Whether the bond trades at a premium, discount or par"
                  },
                  "current_yield_percent": {
                    "type": "number",
                    "description": "Current yield, as a percentage"
                  },
                  "macaulay_duration_years": {
                    "type": "number",
                    "description": "Macaulay duration years"
                  },
                  "modified_duration": {
                    "type": "number",
                    "description": "Modified duration"
                  },
                  "convexity": {
                    "type": "number",
                    "description": "Convexity of the bond"
                  },
                  "note": {
                    "type": "string",
                    "description": "Caveat or context for reading the result"
                  },
                  "source": {
                    "type": "string",
                    "description": "Data source the values come from"
                  },
                  "annual_coupon_income": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Annual coupon income"
                  },
                  "price_change_if_yield_rises_1pt_percent": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Price change if yield rises 1pt, as a percentage"
                  },
                  "price_change_if_yield_falls_1pt_percent": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Price change if yield falls 1pt, as a percentage"
                  },
                  "approx_price_move_per_1pt_usd": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Approx price move per 1pt, in US dollars"
                  }
                },
                "required": [
                  "inputs",
                  "price",
                  "yield_to_maturity"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "bond price from yield",
    "yield to maturity calculator",
    "bond duration and convexity",
    "is a bond at a premium",
    "price change if rates rise one"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.940Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "coupon": {
          "type": "string",
          "description": "Annual coupon rate as decimal (0.05 = 5%)"
        },
        "freq": {
          "type": "string",
          "description": "optional payments per year 1, 2 (default), 4 or 12"
        },
        "years": {
          "type": "string",
          "description": "Years to maturity"
        },
        "ytm": {
          "type": "string",
          "description": "Yield to maturity decimal (to compute price)"
        }
      },
      "required": [
        "coupon",
        "years",
        "ytm"
      ]
    },
    "exampleResponse": {
      "inputs": {
        "face_value": 1000,
        "annual_coupon_rate": 0.05,
        "years_to_maturity": 10,
        "payments_per_year": 2
      },
      "yield_to_maturity": 0.045,
      "yield_to_maturity_percent": 4.5,
      "price": 1039.9093,
      "price_percent_of_par": 103.991,
      "trading": "premium",
      "current_yield_percent": 4.808,
      "annual_coupon_income": 50,
      "macaulay_duration_years": 8.0356,
      "modified_duration": 7.8587,
      "convexity": 74.5506,
      "price_change_if_yield_rises_1pt_percent": -7.486,
      "price_change_if_yield_falls_1pt_percent": 8.231,
      "approx_price_move_per_1pt_usd": -77.847,
      "note": "Plain-vanilla fixed-coupon bond priced at a coupon date (no accrued interest, no call or default risk). Pass ytm to get price and risk measures, or price to solve the yield by bisection.",
      "source": "discounted cash flow"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "coupon": "0.05",
              "freq": "2",
              "years": "10",
              "ytm": "0.045"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "inputs": {
                "face_value": 1000,
                "annual_coupon_rate": 0.05,
                "years_to_maturity": 10,
                "payments_per_year": 2
              },
              "yield_to_maturity": 0.045,
              "yield_to_maturity_percent": 4.5,
              "price": 1039.9093,
              "price_percent_of_par": 103.991,
              "trading": "premium",
              "current_yield_percent": 4.808,
              "annual_coupon_income": 50,
              "macaulay_duration_years": 8.0356,
              "modified_duration": 7.8587,
              "convexity": 74.5506,
              "price_change_if_yield_rises_1pt_percent": -7.486,
              "price_change_if_yield_falls_1pt_percent": 8.231,
              "approx_price_move_per_1pt_usd": -77.847,
              "note": "Plain-vanilla fixed-coupon bond priced at a coupon date (no accrued interest, no call or default risk). Pass ytm to get price and risk measures, or price to solve the yield by bisection.",
              "source": "discounted cash flow"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "coupon": {
                      "type": "string",
                      "description": "Annual coupon rate as decimal (0.05 = 5%)"
                    },
                    "freq": {
                      "type": "string",
                      "description": "optional payments per year 1, 2 (default), 4 or 12"
                    },
                    "years": {
                      "type": "string",
                      "description": "Years to maturity"
                    },
                    "ytm": {
                      "type": "string",
                      "description": "Yield to maturity decimal (to compute price)"
                    }
                  },
                  "required": [
                    "coupon",
                    "years",
                    "ytm"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "inputs": {
                      "type": "object",
                      "description": "Inputs used: face value, annual coupon rate, years to maturity and payments per year"
                    },
                    "yield_to_maturity": {
                      "type": "number",
                      "description": "Yield to maturity"
                    },
                    "yield_to_maturity_percent": {
                      "type": "number",
                      "description": "Yield to maturity, as a percentage"
                    },
                    "price": {
                      "type": "number",
                      "description": "Price"
                    },
                    "price_percent_of_par": {
                      "type": "number",
                      "description": "Price percent of par"
                    },
                    "trading": {
                      "type": "string",
                      "description": "Whether the bond trades at a premium, discount or par"
                    },
                    "current_yield_percent": {
                      "type": "number",
                      "description": "Current yield, as a percentage"
                    },
                    "macaulay_duration_years": {
                      "type": "number",
                      "description": "Macaulay duration years"
                    },
                    "modified_duration": {
                      "type": "number",
                      "description": "Modified duration"
                    },
                    "convexity": {
                      "type": "number",
                      "description": "Convexity of the bond"
                    },
                    "note": {
                      "type": "string",
                      "description": "Caveat or context for reading the result"
                    },
                    "source": {
                      "type": "string",
                      "description": "Data source the values come from"
                    },
                    "annual_coupon_income": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Annual coupon income"
                    },
                    "price_change_if_yield_rises_1pt_percent": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Price change if yield rises 1pt, as a percentage"
                    },
                    "price_change_if_yield_falls_1pt_percent": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Price change if yield falls 1pt, as a percentage"
                    },
                    "approx_price_move_per_1pt_usd": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Approx price move per 1pt, in US dollars"
                    }
                  },
                  "required": [
                    "inputs",
                    "price",
                    "yield_to_maturity"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/finance/bond?coupon=0.05&years=10&ytm=0.045&freq=2",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "inputs": {},
    "yield_to_maturity": 0,
    "yield_to_maturity_percent": 0,
    "price": 0,
    "price_percent_of_par": 0,
    "trading": "string",
    "current_yield_percent": 0,
    "macaulay_duration_years": 0,
    "modified_duration": 0,
    "convexity": 0,
    "note": "string",
    "source": "string",
    "annual_coupon_income": 0,
    "price_change_if_yield_rises_1pt_percent": 0,
    "price_change_if_yield_falls_1pt_percent": 0,
    "approx_price_move_per_1pt_usd": 0
  }
}