API product catalogSub-Accounts & White-Label Retail KYC

Remove symbol from watchlist

Sub-Accounts & White-Label Retail KYC

DELETE

/users/{userId}/watchlist/{symbol}

Sandbox availableremoveFromWatchlist

Removes a stock from a sub-account's watchlist. Returns 404 if the symbol is not on the watchlist.

Parameters

userIdstringpathRequired

Example: usr_abc123

symbolstringpathRequired

Exchange-qualified ticker symbol (e.g. SCOM.KE).

Example: SCOM.KE

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Idempotency-KeystringheaderRequired

Unique string that makes write calls safe to retry on network failure. Required for money movement, trading, KYC, subscriptions, and webhook creation. Deduplicated for 24 hours -- duplicate keys return the cached response. HTTP 409 if a concurrent request with the same key is still in progress.

Example: dep_user42_1743152580

Response fields

See the response format and API Reference for this endpoint.

Response codes

204Symbol removed. No response body.

404Symbol not on watchlist or sub-account not found.

Request reference

Sandbox available

userId Required · pathsymbol Required · path

Use the API Tester for write requests, including request bodies and idempotency keys.

https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D/watchlist/%7Bsymbol%7D

Open in API Tester API Reference

Response format

Symbol removed. No response body.

curl -X DELETE 'https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D/watchlist/%7Bsymbol%7D' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID"

POST /users/{userId}/watchlist

POST /users/{userId}/withdraw