Broker API

MyStocks Partner API

Build embedded investing infrastructure with MyStocks accounts, funding, KYC, trading, events, reporting, and reconciliation.

Integration guides Get a sandbox key

Explore endpoints

79 of 79

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 Broker API is the end-to-end partner workflow for embedding investing into your product. It combines customer sub-accounts, USD wallets, funding and withdrawals, partner-asserted KYC, trading, webhooks, reports, and production certification.

Recommended sequence

Get credentials and understand environments.
Complete Getting Started with Broker API in sandbox.
Create and manage sub-accounts.
Add funding and withdrawals.
Add webhooks and SSE events.
Build reconciliation and reports.
Submit go-live evidence.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Send note

Last updated on

Paper and Demo Trading

Getting Started with Broker API

Broker API

Explore endpoints

/bonds

Parameters

Headers

Response fields

Response codes

Recommended sequence

Broker capabilities

Account opening

Funding

Operations

Events

On this page