Trading API

Account Activities

MyStocks Partner API

Consume the unified activity feed, wallet transactions, order executions, KYC changes, dividends, and account events.

Integration guides Get a sandbox key

Explore endpoints

5 of 5

GET

/users/{userId}/orders/{orderId}/executions

Get sub-account order execution reports

Full endpoint documentation

Sandbox availablegetUserOrderExecutions

Returns OMS execution reports for a sub-account order, including receipt, fill, rejection, and cancellation reports.

Parameters

userIdstringpathRequired

Example: usr_abc123

orderIdstringpathRequired

Example: ord_abc123xyz

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

orderIdstring

subAccountIdstring | null

executionsobject[]

executions[].executionReportIdstring

executions[].journalVersioninteger | null

executions[].immutableboolean

executions[].eventHashAlgorithmstring | null

executions[].eventHashstring | null

executions[].orderIdstring

executions[].clientOrderIdstring | null

executions[].accountTypeMASTER | SUBACCOUNT

executions[].subAccountIdstring | null

executions[].sideBUY | SELL

executions[].symbolstring

executions[].exchangestring | null

executions[].requestedQuantitynumber

executions[].filledQuantitynumber

executions[].remainingQuantitynumber

executions[].fillPricenumber | null

executions[].averageFillPricenumber | null

executions[].feeAmountnumber | null

executions[].netAmountnumber | null

executions[].currencystring

Example: "USD"

executions[].executionVenuestring | null

executions[].actorTypestring | null

executions[].actorIdstring | null

executions[].requestIdstring | null

executions[].sourcestring | null

executions[].correctsExecutionReportIdstring | null

executions[].syntheticboolean

True only for a read-time compatibility FILL derived from a legacy filled order that predates the immutable execution journal.

executions[].sourceEvidencestring | null

executions[].createdAtstring | null

executions[].occurredAtstring | null

executions[].recordedAtstring | null

countinteger

Response codes

200Execution reports for the order.

404Sub-account or order not found.

Sandbox playground

Read-only sandbox request

userId Required · pathorderId Required · pathSandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D/orders/%7BorderId%7D/executions

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "string"
    },
    "subAccountId": {
      "type": [
        "string",
        "null"
      ]
    },
    "executions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "executionReportId": {
            "type": "string"
          },
          "journalVersion": {
            "type": [
              "integer",
              "null"
            ]
          },
          "immutable": {
            "type": "boolean"
          },
          "eventHashAlgorithm": {
            "type": [
              "string",
              "null"
            ]
          },
          "eventHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "orderId": {
            "type": "string"
          },
          "clientOrderId": {
            "type": [
              "string",
              "null"
            ]
          },
          "accountType": {
            "type": "string",
            "enum": [
              "MASTER",
              "SUBACCOUNT"
            ]
          },
          "subAccountId": {
            "type": [
              "string",
              "null"
            ]
          },
          "reportType": {
            "type": "string",
            "enum": [
              "ORDER_RECEIVED",
              "FILL",
              "REJECT",
              "CANCEL",
              "REPLACE",
              "CORRECTION"
            ]
          },
          "orderStatus": {
            "type": "string",
            "enum": [
              "RECEIVED",
              "FILLED",
              "REJECTED",
              "CANCELLED",
              "REPLACED",
              "WORKING"
            ]
          },
          "side": {
            "type": "string",
            "enum": [
              "BUY",
              "SELL"
            ]
          },
          "symbol": {
            "type": "string"
          },
          "exchange": {
            "type": [
              "string",
              "null"
            ]
          },
          "requestedQuantity": {
            "type": "number"
          },
          "filledQuantity": {
            "type": "number"
          },
          "remainingQuantity": {
            "type": "number"
          },
          "fillPrice": {
            "type": [
              "number",
              "null"
            ]
          },
          "averageFillPrice": {
            "type": [
              "number",
              "null"
            ]
          },
          "feeAmount": {
            "type": [
              "number",
              "null"
            ]
          },
          "netAmount": {
            "type": [
              "number",
              "null"
            ]
          },
          "currency": {
            "type": "string",
            "example": "USD"
          },
          "executionVenue": {
            "type": [
              "string",
              "null"
            ]
          },
          "actorType": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "PARTNER_KEY",
              "ADMIN_USER",
              "SYSTEM_JOB",
              null
            ]
          },
          "actorId": {
            "type": [
              "string",
              "null"
            ]
          },
          "requestId": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          },
          "correctsExecutionReportId": {
            "type": [
              "string",
              "null"
            ]
          },
          "synthetic": {
            "type": "boolean",
            "description": "True only for a read-time compatibility FILL derived from a legacy filled order that predates the immutable execution journal."
          },
          "sourceEvidence": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "LEGACY_ORDER_STATE",
              null
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "occurredAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "recordedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        }
      }
    },
    "count": {
      "type": "integer"
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D/orders/%7BorderId%7D/executions' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

Use account activities to build an internal ledger and customer timeline. The feed is not a replacement for reconciliation; it is the event-oriented view used to explain state changes.

Activity sources

GET /client-activity — partner-wide reverse-chronological activity feed.
GET /users/{userId}/transactions — complete sub-account wallet ledger.
GET /orders/{orderId}/executions — master order execution reports.
GET /users/{userId}/orders/{orderId}/executions — sub-account execution reports.
GET /stream and signed webhooks — live notifications.

Persist the activity ID, event type, account ID, order ID or transaction ID, timestamp, currency, amount, and X-Request-ID. Treat duplicate events as normal and use eventId for webhook/SSE deduplication.

For period-end reporting, combine this feed with Statements and Confirms and Daily Reconciliation.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Send note

Last updated on

Portfolio Performance

Placing Orders