Trading API

Getting Started with Trading API

MyStocks Partner API

Place, observe, and reconcile a sandbox trade with the MyStocks Partner API.

Integration guides Get a sandbox key

Explore endpoints

59 of 59

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"

Workflow

Authenticate with a sandbox partner key.
Create or select a verified sub-account, or use the master account.
Request a quote using the exact symbol, side, quantity, or cashValue.
Place the order with the returned quoteId and an Idempotency-Key.
Poll order status or subscribe to signed webhook/SSE events.
Inspect executions, portfolio, buying power, and ledger entries.
Reconcile the completed trade against the daily report.

The full request sequence is in Trading, including market, limit, stop, time-in-force, cancellation, and fractional cash-value examples.

Important invariants

Never reuse an expired or already-consumed quote.
Never generate a new idempotency key when retrying the same write.
Treat webhook delivery as at-least-once and potentially out of order.
Do not treat a submitted or pending order as settled custody.

Use the API Tester for individual calls and the API Reference for the exact request schema.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Send note

Last updated on