API product catalogExecution & Order Management (OMS)

Settlement cycles and live fill target

Execution & Order Management (OMS)

GET

/market/settlement

Sandbox availablegetMarketSettlement

Returns the official T+N settlement cycle for each supported exchange (i.e. when title and beneficial ownership transfer after trade execution), plus the MyStocks live fill SLA for market orders submitted during exchange hours. Important distinction - MyStocks live fill SLA — the time before a PENDING live order moves to COMPLETED or REJECTED. Execution window: 1 to 5 minutes during market hours. - Exchange settlement cycle — the standard T+N cycle mandated by the exchange and its CSD. This governs when the underlying shares clear through the depository (T+2 for EGX, T+3 for all other supported exchanges). Use ?exchange=NSE to filter to a single exchange.

Parameters

exchangestringquery

Filter to a single exchange code (NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM).

Example: NSE

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

processingWindowobject

processingWindow.targetTurnaroundHoursnumber

Legacy hour equivalent of the live 5-minute fill target.

Example: 0.083

processingWindow.minTurnaroundMinutesinteger

Earliest expected live execution window, in minutes.

Example: 1

processingWindow.maxTurnaroundMinutesinteger

Maximum live execution window, in minutes.

Example: 5

processingWindow.targetTurnaroundMinutesinteger

Monitoring deadline between live market order submission and fill/rejection during market hours.

Example: 5

processingWindow.descriptionstring

processingWindow.outsideHoursNotestring

processingWindow.processingDaysstring

Example: "Monday – Friday (excluding public holidays)"

processingWindow.webhookNotestring

processingWindow.pollEndpointstring

Example: "GET /api/v1/partner/orders/{orderId}"

exchangesobject

Response codes

200Settlement cycles and live fill target.

401Unauthorized.

404Unknown exchange code.

Sandbox playground

Read-only sandbox request

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

https://mystocks.africa/api/sandbox/v1/partner/market/settlement

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "processingWindow": {
      "type": "object",
      "properties": {
        "targetTurnaroundHours": {
          "type": "number",
          "example": 0.083,
          "description": "Legacy hour equivalent of the live 5-minute fill target."
        },
        "minTurnaroundMinutes": {
          "type": "integer",
          "example": 1,
          "description": "Earliest expected live execution window, in minutes."
        },
        "maxTurnaroundMinutes": {
          "type": "integer",
          "example": 5,
          "description": "Maximum live execution window, in minutes."
        },
        "targetTurnaroundMinutes": {
          "type": "integer",
          "example": 5,
          "description": "Monitoring deadline between live market order submission and fill/rejection during market hours."
        },
        "description": {
          "type": "string"
        },
        "outsideHoursNote": {
          "type": "string"
        },
        "processingDays": {
          "type": "string",
          "example": "Monday – Friday (excluding public holidays)"
        },
        "webhookNote": {
          "type": "string"
        },
        "pollEndpoint": {
          "type": "string",
          "example": "GET /api/v1/partner/orders/{orderId}"
        }
      }
    },
    "exchanges": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "exchange": {
            "type": "string",
            "example": "NSE"
          },
          "name": {
            "type": "string",
            "example": "Nairobi Securities Exchange"
          },
          "country": {
            "type": "string",
            "example": "Kenya"
          },
          "currency": {
            "type": "string",
            "example": "KES"
          },
          "cycle": {
            "type": "string",
            "example": "T+3",
            "description": "Official exchange settlement cycle."
          },
          "cycleDays": {
            "type": "integer",
            "example": 3
          },
          "notes": {
            "type": "string"
          }
        }
      }
    }
  }
}

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

GET /market/clock

GET /market/status