Document
MyStocks Partner API SLA v2.1
Effective
01 January 2025
Revised
01 May 2026
Owner
MyStocks Technology Ltd
1. Overview & Scope
This Service Level Agreement ("SLA") defines the operational commitments MyStocks Technology Ltd ("MyStocks", "we", "us") makes to authorised API Partners ("Partner", "you") accessing the MyStocks Partner API platform. This SLA is incorporated into the Partner API Terms of Service and sets the service expectations for production access, trading services, market data, payments, settlement, and partner support.
Coverage includes production API endpoints, webhook event delivery, Partner Dashboard availability, partner onboarding workflows, and settlement infrastructure. This SLA does not apply to sandbox environments, experimental preview features, or services that are explicitly identified as provided by third-party vendors outside MyStocks direct control.
Covered product classes include Stocks, Bonds, ETFs, and Funds. This SLA applies to order execution, portfolio valuation, corporate actions, settlement notifications, reporting, and custody-related workflows for these asset classes when accessed through the MyStocks Partner API.
SLA commitments begin when the Partner's production API key (prefixed pk_live_) is issued, and remain in force while the Partner maintains an active commercial relationship with MyStocks.
- Applies to production API traffic only; test and sandbox traffic is provided for evaluation and is not guaranteed.
- Availability is measured at the MyStocks API gateway and does not include upstream exchange or payment processor outages.
- Service credits are available only for covered services and do not compensate for market loss, trading P&L, or regulatory actions.
- Partners are expected to maintain secure production endpoints, monitor their own integration health, and cooperate promptly during incident response.
- B2B partner obligations include timely onboarding of sub-accounts, reconciliation of cash and securities ledgers, and participation in incident drills for mission-critical flows.
MyStocks also commits to B2B wealth platform support for portfolio aggregation, tax lot accounting, corporate action notifications, multi-currency position reporting, and end-of-day reconciliation data feeds. Core partner capabilities include account provisioning APIs, real-time portfolio valuation, performance metrics, and capital movement traceability.
For investment platforms, this SLA supports delivery of consistent portfolio data, reliable order status updates, and settlement confirmation for Stocks, Bonds, ETFs, and Funds while maintaining regulatory-grade auditability and dispute support.
2. Definitions
| Term | Definition |
|---|---|
| Availability | Percentage of time in a calendar month that the API returns a successful response for valid production requests, excluding Scheduled Maintenance and agreed exclusions. |
| Downtime | A contiguous period of degraded or unavailable service lasting five minutes or longer, measured at the MyStocks API gateway. |
| Incident | Any unplanned event that causes or may cause service degradation, reduced performance, or disruption to covered Partner functionality. |
| Scheduled Maintenance | Planned maintenance windows announced at least 72 hours in advance, during which Availability targets are temporarily suspended. |
| Settlement Window | The timeframe between transaction execution and final custody allocation or fund settlement, as defined for each asset class. |
| Monthly Uptime % | (Total minutes in month − Downtime minutes) ÷ Total minutes in month × 100. |
| Credit | A service credit applied against the Partner’s next month’s API usage invoice for verified SLA breaches. |
| Business Day | Monday through Friday excluding gazetted public holidays in Kenya, unless otherwise agreed in writing. |
| P0 / P1 / P2 / P3 | Incident severity levels that define impact, response expectations, and escalation paths. |
| CSM | Customer Success Manager assigned to Enterprise Partners for proactive support and account advocacy. |
| RTO | Recovery Time Objective — the maximum targeted time to restore service after an incident declaration. |
| RPO | Recovery Point Objective — the maximum targeted amount of data loss in a disaster or failover event. |
| Webhook Delivery | The successful transmission and acknowledgement of event payloads to a Partner endpoint. |
| API Throughput | The number of valid requests processed by MyStocks per second, subject to rate limit policies. |
| KYC / AML Flow | Partner onboarding and sub-account verification processes that may include identity, PEP, and sanctions screening. |
| Exchange Connectivity | The link between MyStocks infrastructure and an external securities exchange used for order routing and market data. |
3. Service Tiers
MyStocks offers three partner service tiers. Tier assignment is determined at the time of partnership agreement and can be upgraded with written notice to MyStocks commercial team. Each tier defines the partner’s uptime commitment, support coverage, incident cadence, and change management privileges.
Startups, developers, research platforms
Fintechs, neobanks, wealth apps
Banks, regulated institutions, high-volume
4. Service Level Objectives
The following availability targets apply per calendar month for each covered service. Availability is measured across all production API endpoints, partner-facing workflows, and automated monitoring probes. Availability calculations exclude Scheduled Maintenance and agreed exclusions.
| Service | Standard | Professional | Enterprise |
|---|---|---|---|
| Trading API (orders, portfolio) | 99.5% | 99.9% | 99.95% |
| Market Data API (prices, stocks) | 99.5% | 99.9% | 99.95% |
| Payment Rails (deposits, withdrawals) | 99.0% | 99.5% | 99.9% |
| Webhooks (event delivery) | 99.0% | 99.5% | 99.9% |
| Partner Dashboard | 99.0% | 99.5% | 99.9% |
| Partner Portal Authentication | 99.5% | 99.9% | 99.95% |
Operational SLAs (non-availability commitments)
| Metric | Standard | Professional | Enterprise |
|---|---|---|---|
| API median response time (p50) | <800ms | <500ms | <300ms |
| API 99th percentile response time (p99) | <3s | <2s | <1s |
| Trade order acknowledgement | <2s | <1s | <500ms |
| Market data refresh interval | ≤15s | ≤10s | ≤5s |
| Webhook delivery (p95) | ≤30s | ≤10s | ≤5s |
| Webhook retry window | 24h | 48h | 72h |
| Payment instruction acknowledgement | ≤30m | ≤15m | ≤5m |
| Deposit credit (after on-chain / bank confirmation) | ≤4h | ≤2h | ≤1h |
| Withdrawal initiation (after approval) | ≤1 Business Day | ≤4h | ≤2h |
| Settlement confirmation (equity, NSE/NGX) | ≤T+3 | ≤T+3 | ≤T+2 (priority) |
| KYC / AML verification response | ≤24h | ≤12h | ≤6h |
| Risk review escalation acknowledgment | ≤1h | ≤30m | ≤15m |
5. Incident Classification
All incidents are classified by severity at the time of declaration. Classification may be upgraded or downgraded as the incident evolves. The declaring party is responsible for initial classification; MyStocks engineering reserves the right to reclassify.
| Severity | Definition | Examples | User Impact |
|---|---|---|---|
| P0 | Complete service outage. Core API is unreachable or returning errors for all requests. | API returning 5xx for all endpoints; exchange connectivity lost; payment rails fully down | All Partners unable to operate. Trading halted. |
| P1 | Critical degradation. Core functionality severely impaired for a significant subset of partners. | Order submission failing; market data delayed >30min; webhook delivery stopped; settlement stalled | Most partners affected. Core flows broken for subset. |
| P2 | Partial degradation. Non-critical or non-core functionality impaired. Workarounds available. | Specific exchange data unavailable; report endpoints slow; sandbox environment down | Some partners see errors. Core trading unaffected. |
| P3 | Minor issue or service inquiry. No material impact on operations. | Documentation error; cosmetic UI bug on dashboard; delayed non-critical notification | Minimal impact. No trading disruption. |
6. Response & Resolution SLAs
Response time begins when MyStocks receives a validated incident report or detects an automated alert for a covered service. Resolution time begins when MyStocks confirms incident ownership and ends when normal service is restored or a permanent workaround is in production.
Standard Tier
| Severity | Acknowledgement | First Update | Resolution Target |
|---|---|---|---|
| P0 | 30 minutes | 2 hours | 8 hours |
| P1 | 2 hours | 4 hours | 24 hours |
| P2 | 8 hours | 24 hours | 72 hours |
| P3 | 24 hours | 48 hours | 10 Business Days |
Professional Tier
| Severity | Acknowledgement | First Update | Resolution Target |
|---|---|---|---|
| P0 | 15 minutes | 1 hour | 4 hours |
| P1 | 30 minutes | 2 hours | 12 hours |
| P2 | 4 hours | 8 hours | 48 hours |
| P3 | 8 hours | 24 hours | 5 Business Days |
Enterprise Tier
| Severity | Acknowledgement | First Update | Resolution Target |
|---|---|---|---|
| P0 | 5 minutes | 30 minutes | 2 hours |
| P1 | 15 minutes | 1 hour | 6 hours |
| P2 | 1 hour | 4 hours | 24 hours |
| P3 | 4 hours | 8 hours | 3 Business Days |
Resolution targets are best-effort commitments. Complex incidents involving third-party exchanges, regulators, or custodians may extend resolution timelines beyond these targets. In such cases, MyStocks will provide status updates at minimum every 30 minutes for P0 incidents and every 4 hours for P1 incidents until a mitigation plan is implemented.
7. Credits & Remedies
If MyStocks fails to meet the Monthly Uptime % SLO for a covered service in a calendar month, the Partner may request a Service Credit. Credits are applied against the next month’s API usage invoice and are not redeemable for cash unless required by applicable law.
Credit schedule — Standard (99.5% SLO)
| Monthly Uptime Achieved | Credit (% of that month's API fee) |
|---|---|
| 99.0% – 99.49% | 5% |
| 95.0% – 98.99% | 15% |
| < 95.0% | 25% |
Credit schedule — Professional (99.9% SLO)
| Monthly Uptime Achieved | Credit (% of that month's API fee) |
|---|---|
| 99.5% – 99.89% | 10% |
| 99.0% – 99.49% | 25% |
| < 99.0% | 50% |
Credit schedule — Enterprise (99.95% SLO)
| Monthly Uptime Achieved | Credit (% of that month's API fee) |
|---|---|
| 99.9% – 99.94% | 15% |
| 99.5% – 99.89% | 30% |
| < 99.5% | 50% + CSM escalation review |
Calculation details
Service Credits are calculated using the difference between the applicable SLO and the actual Monthly Uptime %. The total credit is capped at the percentage shown in the schedule, subject to the overall monthly cap.
How to claim
Partners must submit a credit request to sla@mystocks.africa within 30 calendar days after the end of the affected month. Requests must include: incident ID(s), affected service(s), claimed downtime windows, impact summary, and any partner-side mitigation steps taken.
MyStocks will review claims against internal monitoring, partner logs, and any jointly agreed telemetry, and will confirm or adjust the credit amount within 10 Business Days of receipt.
8. Escalation Matrix
Use the appropriate channel for the incident severity. Routing to the wrong channel may delay response and can affect SLA measurement.
| Severity | Tier | Primary Channel | Contact / Queue | Coverage |
|---|---|---|---|---|
| P0 | All | Emergency Hotline | +254 700 000 000 | 24/7 |
| P1 | Enterprise | Dedicated CSM | CSM direct line (onboarding email) | 24/7 |
| P1 | Professional | WhatsApp + Email | +254 700 000 001 · sla@mystocks.africa | Extended (06:00–22:00 EAT) |
| P1 | Standard | sla@mystocks.africa | Business hours | |
| P2 | All | support@mystocks.africa | Business hours | |
| P3 | All | Partner Portal / Email | support@mystocks.africa | Business hours |
Escalation path within MyStocks
L3 and L4 escalation is automatic for P0 incidents lasting more than 30 minutes without an identified mitigation path. Partners may request escalation at any time by explicitly stating "request L3 escalation" in incident communications.
9. Maintenance Windows
| Type | Advance Notice | Typical Window | Notification Channel |
|---|---|---|---|
| Standard Maintenance | ≥72 hours | Saturday 01:00–05:00 EAT | SLA Portal + Email |
| Emergency Patch | ≥2 hours (where possible) | Any time, <30min target | SLA Portal + Email + WhatsApp (Pro/Ent) |
| Exchange-Driven Downtime | Best-effort | Varies per exchange | SLA Portal |
| Major Infrastructure Upgrade | ≥14 days | Saturday 00:00–08:00 EAT | SLA Portal + Email + Dedicated comms |
| Blackout / Close-of-day | Not applicable | Typically no changes | SLA Portal |
Standard maintenance windows are scheduled for Saturday mornings (East Africa Time) to minimise impact on African trading hours. MyStocks targets zero-downtime deployments, but may perform brief rolling updates with service interruption not exceeding five minutes per service component.
Partners subscribed to SLA Portal notifications receive automated alerts when a maintenance window is published. Enterprise Partners receive direct email and a CSM briefing for any window affecting core trading, settlement, or payment infrastructure.
MyStocks will not schedule disruptive maintenance during declared blackout periods including local end-of-month closing and settlement cut-off windows unless an urgent security or regulatory issue requires immediate action.
10. Data Retention & Recovery
| Data Type | Retention Period | Backup Frequency | RPO |
|---|---|---|---|
| Transaction records | 7 years (regulatory) | Continuous (WAL) | <1 minute |
| Order & trade history | 7 years (regulatory) | Continuous (WAL) | <1 minute |
| User & sub-account data | Duration + 5 years | Hourly snapshots | <1 hour |
| Market data (OHLCV) | 10 years | Daily snapshots | <24 hours |
| Webhook delivery logs | 90 days | Daily snapshots | <24 hours |
| API access logs | 1 year | Daily snapshots | <24 hours |
| Partner API keys (hashed) | Duration of partnership | Continuous | <1 minute |
All data is stored in multi-region Google Cloud Firestore with automatic point-in-time recovery and encryption at rest. Data in transit is protected by TLS 1.2+ for all partner-facing services.
Backup retention for transactional and trade data exceeds regulatory minima in Kenya (CMA), Nigeria (SEC), and South Africa (FSCA). Audit trails and access logs are maintained to support investigations and compliance review requests.
11. Business Continuity
MyStocks maintains a Business Continuity Plan (BCP) and Disaster Recovery Plan (DRP) reviewed annually and tested semi-annually. These plans ensure continuity for trading, settlement, payment processing, and compliance-critical workflows.
| Scenario | RTO | RPO | Notes |
|---|---|---|---|
| Single region failure | < 30 minutes | < 1 minute | Automatic failover to secondary region |
| Multi-region failure | < 4 hours | < 1 hour | Manual DR activation, status updates every 30 minutes |
| Exchange connectivity loss | < 1 hour | N/A | Orders queued and replayed on reconnection where permitted |
| Payment rail failure | < 2 hours | < 1 minute | Failover to alternate payment processor or settlement path |
| Key-person dependency | < 2 hours | N/A | On-call rotation and documented runbooks for critical roles |
| Cybersecurity incident | < 2 hours | < 1 hour | IR playbook activated; regulators notified per applicable law |
Partners will be notified of any BCP activation within 30 minutes of the decision to activate, with updates every 30 minutes until normal operations resume. Post-incident Root Cause Analysis (RCA) is published within 5 Business Days for P0/P1 events, and within 10 Business Days for P2 events.
12. Partner Obligations
Partner SLA benefits are conditional on Partners meeting the following obligations. Failure to comply may reduce SLA eligibility or limit credit entitlement.
- Maintain up-to-date contact and escalation information in the Partner Portal for incident and compliance notifications.
- Respond to MyStocks escalations within 2 hours for P0/P1 incidents affecting the Partner’s production flows.
- Implement webhook endpoints that return 200 within 30 seconds and handle retries idempotently.
- Do not exceed documented API rate limits. Excessive requests and abusive patterns are excluded from Availability calculations.
- Use TLS 1.2+ and mutually agreed certificate validation for all production integrations.
- Notify MyStocks of planned volume, product, or geographic expansions that may affect throughput or risk screening.
- Keep API keys confidential and rotate compromised keys immediately. MyStocks is not liable for unauthorised usage due to Partner security failures.
- Ensure sub-account KYC, AML, and sanctions screening policies are implemented as required by applicable law.
- Test major integration changes in sandbox before deploying to production, and notify MyStocks for any change requiring coordinated release support.
- Preserve audit logs for partner-side actions that affect trading, settlement, reconciliation, or compliance reporting.
13. Exclusions & Limitations
The following are excluded from SLA coverage and Availability calculations:
- Scheduled Maintenance periods notified in accordance with Section 9.
- Exchange-imposed trading halts, circuit breakers, or regulatory suspensions.
- Force majeure events including natural disasters, acts of war, pandemic disruptions, or government-mandated service suspension.
- Downtime caused by Partner misconfigurations, incorrect API usage, or failure to implement required security controls.
- Third-party payment processor outages beyond MyStocks control (Kredete, Busha, Blockradar).
- Sandbox environment — sandbox is provided as-is with no availability commitment.
- Beta, experimental, or preview features explicitly labelled as such.
- Incidents caused by Partner exceeding documented rate limits.
- API key compromise or unauthorised access resulting from Partner-side security failures.
- Market data delays attributable to the originating exchange.
- Regulatory or compliance actions by a government or supervisory authority that restrict trading or access.
- Delays in partner-side reconciliation, settlement matching, or reconciliation queries.
14. Amendments & Notices
MyStocks may update this SLA by providing written notice to Partners at least 30 days prior to the effective date of any material change. Notices are delivered to the email address registered on the Partner account and published in the SLA portal.
Partners who do not accept an amended SLA must notify MyStocks in writing within 14 days of the notice. Continued use of the MyStocks Partner API after the effective date constitutes acceptance of the amended SLA.
This SLA is governed by the laws of Kenya. Any disputes shall first be referred to the parties' senior management for good-faith resolution within 30 days. Unresolved disputes shall be subject to arbitration in Nairobi, Kenya under the Nairobi Centre for International Arbitration (NCIA) rules.
For SLA inquiries, credit requests, or amendment objections, contact:
SLA & Credits
sla@mystocks.africa
General Support
support@mystocks.africa
Legal / Compliance
legal@mystocks.africa