Trading API

MyStocks Partner API

Quote, place, monitor, cancel, and reconcile MyStocks master-account and sub-account orders.

Integration guides Get a sandbox key

Explore endpoints

22 of 22

GET

/bonds

List bonds & fixed income

Full endpoint documentation

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"

The Trading API is the order and portfolio lane of the Partner API. It supports quote-gated market orders, resting order types, executions, portfolios, buying power, fractional cash-value investing, and order lifecycle events.

For analytics, use Portfolio Performance for cash-flow-adjusted daily P&L, linked time-weighted return, and optional benchmark comparison. /portfolio/history remains the raw equity-snapshot surface.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Send note

Last updated on

Corporate actions and shareholder voting

Getting Started with Trading API

Trading API

Explore endpoints

/bonds

Parameters

Headers

Response fields

Response codes

Get started

Order lifecycles

Trading guide

API Tester

On this page