API product catalogExecution & Order Management (OMS)

List bonds & fixed income

Execution & Order Management (OMS)

GET

/bonds

Sandbox availablelistBonds

Returns all available bonds, treasury bills, and fixed-income instruments. Includes coupon rate, maturity date, minimum investment, and current yield.

Parameters

instrumentTypestringquery

currencystringquery

exchangestringquery

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

bondsobject[]Required

bonds[].idstringRequired

bonds[].namestring | nullRequired

bonds[].symbolstring | nullRequired

bonds[].issuerstring | nullRequired

bonds[].instrumentTypestringRequired

bonds[].assetTypestringRequired

bonds[].currencystring | nullRequired

bonds[].faceValuenumberRequired

bonds[].pricePerUnitnumberRequired

bonds[].couponRatenumber | nullRequired

Percentage points: 12.5 means 12.5%.

bonds[].currentYieldnumber | nullRequired

bonds[].yieldToMaturitynumber | nullRequired

bonds[].minInvestmentnumber | nullRequired

bonds[].maturityDatestring | nullRequired

bonds[].exchangestring | nullRequired

bonds[].statusstringRequired

bonds[].descriptionstring | nullRequired

countintegerRequired

Response codes

200Bond list.

Sandbox playground

Read-only sandbox request

instrumentType Optional · querycurrency Optional · queryexchange Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/bonds

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "required": [
    "bonds",
    "count"
  ],
  "properties": {
    "bonds": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "symbol",
          "issuer",
          "instrumentType",
          "assetType",
          "currency",
          "faceValue",
          "pricePerUnit",
          "couponRate",
          "currentYield",
          "yieldToMaturity",
          "minInvestment",
          "maturityDate",
          "exchange",
          "status",
          "description"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "issuer": {
            "type": [
              "string",
              "null"
            ]
          },
          "instrumentType": {
            "type": "string"
          },
          "assetType": {
            "type": "string",
            "const": "BOND"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "faceValue": {
            "type": "number"
          },
          "pricePerUnit": {
            "type": "number"
          },
          "couponRate": {
            "type": [
              "number",
              "null"
            ],
            "description": "Percentage points: 12.5 means 12.5%."
          },
          "currentYield": {
            "type": [
              "number",
              "null"
            ]
          },
          "yieldToMaturity": {
            "type": [
              "number",
              "null"
            ]
          },
          "minInvestment": {
            "type": [
              "number",
              "null"
            ]
          },
          "maturityDate": {
            "type": [
              "string",
              "null"
            ]
          },
          "exchange": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "count": {
      "type": "integer"
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/bonds' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

Execution & Order Management (OMS)

GET /bonds/{id}