API product catalogExecution & Order Management (OMS)

Bond detail

Execution & Order Management (OMS)

GET

/bonds/{id}

Bond detail

Sandbox availablegetBonds

Returns full detail for a specific bond or fixed-income instrument.

Parameters

idstringpathRequired

Bond document ID from the list endpoint.

Example: ke_tbill_91d_2026

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

idstringRequired

namestring | nullRequired

symbolstring | nullRequired

issuerstring | nullRequired

instrumentTypestringRequired

assetTypestringRequired

currencystring | nullRequired

faceValuenumberRequired

pricePerUnitnumberRequired

couponRatenumber | nullRequired

Percentage points: 12.5 means 12.5%.

currentYieldnumber | nullRequired

yieldToMaturitynumber | nullRequired

minInvestmentnumber | nullRequired

maturityDatestring | nullRequired

exchangestring | nullRequired

statusstringRequired

descriptionstring | nullRequired

Response codes

200Bond detail.

404Bond not found.

Sandbox playground

Read-only sandbox request

id Required · path

Sandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/bonds/%7Bid%7D

Open in API Tester API Reference

Response schema

{
  "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"
      ]
    }
  }
}

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

GET /bonds

GET /buying-power