API product catalogDeveloper Platform, Sandbox & Key Management

Get partner markup pricing

Developer Platform, Sandbox & Key Management

GET

/pricing

Sandbox availablegetPricing

The partner's self-serve markup config — a default markup (bps) added on top of the MyStocks base fee, plus per-symbol / per-exchange / per-asset-class overrides and an optional promo window. Resolution for a trade is most-specific-wins: active promo → symbol → exchange → assetClass → default. Markup is capped at maxMarkupBps.

Parameters

This endpoint has no path or query parameters.

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

defaultMarkupBpsnumber

Default markup (bps) when no override matches.

overridesobject[]

overrides[].scopesymbol | exchange | assetClass

overrides[].keystring

overrides[].markupBpsnumber

promoobject | null

promo.markupBpsnumber

promo.untilstring

promoActiveboolean

Whether the promo window is currently in effect.

maxMarkupBpsnumber

Platform cap on any markupBps.

legacyMarkupBpsnumber

The flat markup used when no pricing config is set.

Response codes

200Current pricing.

Sandbox playground

Read-only sandbox request

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

https://mystocks.africa/api/sandbox/v1/partner/pricing

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "description": "Self-serve markup configuration.",
  "properties": {
    "defaultMarkupBps": {
      "type": "number",
      "description": "Default markup (bps) when no override matches."
    },
    "overrides": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "scope": {
            "type": "string",
            "enum": [
              "symbol",
              "exchange",
              "assetClass"
            ]
          },
          "key": {
            "type": "string"
          },
          "markupBps": {
            "type": "number"
          }
        }
      }
    },
    "promo": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "markupBps": {
          "type": "number"
        },
        "until": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "promoActive": {
      "type": "boolean",
      "description": "Whether the promo window is currently in effect."
    },
    "maxMarkupBps": {
      "type": "number",
      "description": "Platform cap on any markupBps."
    },
    "legacyMarkupBps": {
      "type": "number",
      "description": "The flat markup used when no pricing config is set."
    }
  }
}

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

GET /openapi.yaml

PATCH /pricing