Trading API

Trading Fees and Regulatory Charges

MyStocks Partner API

Explain base fees, partner markup, execution totals, and reporting fields consistently in a customer trading experience.

Integration guides Get a sandbox key

Explore endpoints

2 of 2

GET

/report/fees

Report — Fees

Full endpoint documentation

Sandbox availablelistFees

Returns fees earned by MyStocks and your markup fees, broken down by period and sub-account.

Parameters

fromstringquery

tostringquery

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

partnerKeystringRequired

periodobjectRequired

period.fromstring | nullRequired

period.tostring | nullRequired

totalFeesnumberRequired

tradeCountintegerRequired

currencyUSDRequired

monthlyobject[]Required

monthly[].monthstringRequired

monthly[].feesnumberRequired

monthly[].tradeCountintegerRequired

transactionsobject[]Required

transactions[].idstringRequired

transactions[].orderIdstring

transactions[].symbolstring

transactions[].tradeTypestring

transactions[].amountnumberRequired

transactions[].currencystringRequired

transactions[].createdAtstring | nullRequired

Response codes

200Fee report.

Sandbox playground

Read-only sandbox request

from Optional · queryto Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/report/fees

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "required": [
    "partnerKey",
    "period",
    "totalFees",
    "tradeCount",
    "currency",
    "monthly",
    "transactions"
  ],
  "properties": {
    "partnerKey": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "required": [
        "from",
        "to"
      ],
      "properties": {
        "from": {
          "type": [
            "string",
            "null"
          ]
        },
        "to": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "totalFees": {
      "type": "number"
    },
    "tradeCount": {
      "type": "integer"
    },
    "currency": {
      "type": "string",
      "enum": [
        "USD"
      ]
    },
    "monthly": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "month",
          "fees",
          "tradeCount"
        ],
        "properties": {
          "month": {
            "type": "string"
          },
          "fees": {
            "type": "number"
          },
          "tradeCount": {
            "type": "integer"
          }
        }
      }
    },
    "transactions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "amount",
          "currency",
          "createdAt"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "orderId": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "tradeType": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}

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

The quote response is the source for the estimated transaction economics before a market order. It exposes gross value, base fee, partner markup, total fee, and total cost or proceeds.

Fee fields

Field	Meaning
`gross`	Estimated local/converted notional before fees.
`baseFee`	MyStocks base execution fee.
`partnerMarkupFee`	Partner-configured markup, when applicable.
`fee`	Total displayed fee for the quote.
`totalCost`	BUY amount including fees.

Fees can differ by account, asset class, exchange, and partner pricing configuration. Do not hard-code the current fee rate in a client; read the quote and report endpoints.

Use GET /report/fees and GET /report/revenue for period reporting. Customer-facing disclosures should distinguish MyStocks fees, your own markup, broker/custody charges, taxes, and local-market regulatory charges where applicable.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Send note

Last updated on

Fractional Trading

Order & Money Lifecycles