Trading made simple.
Stockminds API Documentation
Last Updated: July 4, 2025
​
This API provides access to trading data for authorized users with a premium, advanced, expert, or elite plan. Use the /api/login endpoint to obtain an API token, then use the /api/data endpoint to fetch data. The API is available only during trading hours (weekdays after 7:00 AM EDT, excluding US trading holidays).
​
Base URL
​
Authentication
To access the API, you need a valid API token obtained via the /api/login endpoint. Tokens are valid for 24 hours and require a paid subscription plan.
​
Login Endpoint: /api/login
Obtain an API token by providing your email and password.
​
Method: POST
URL: /api/login
Content-Type: application/json
Request Body:
{
"email": "your-email@example.com",
"password": "your-password"
}
Success Response (HTTP 200):
{
"token": "your-api-token",
"expires_at": 1625140800 // Unix timestamp (seconds)
}
Error Responses:
400: {"error": "Email and password required"}
401: {"error": "Invalid credentials"}
404: {"error": "User not found"}
500: {"error": "Authentication failed"} or {"error": "Failed to update metadata"}
Example:
curl -X POST "https://stockminds.ngrok.app/api/login" \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "your-password"}'
​
Data Endpoint: /api/data
Fetch trading data using a valid API token. Data is available only on trading days (Monday–Friday after 7:00 AM EDT, excluding US trading holidays).
​
Method: GET
URL: /api/data?type=top2
Headers:
Authorization: Bearer your-api-token
Query Parameters:
type: Set to top2 to retrieve trade data for the top 2 Stockminds trades.
Success Response (HTTP 200, trading hours):
{
"data": { /* Your trading data structure */ }
}
Non-Trading Responses (HTTP 200):
Weekend: {"message": "It is the weekend. Wait for the next trading day."}
Holiday: {"message": "It is a US holiday. Wait for the next trading day."}
Before 7:00 AM EDT: {"message": "Data is currently unavailable. Wait until Stockminds populates with trade data."}
Error Responses:
400: {"error": "Invalid request type"}
401: {"error": "Token required in Authorization header"} or {"error": "Invalid or expired token"}
403: {"error": "Insufficient privileges"} (requires premium plan)
500: {"error": "Server configuration error"}, {"error": "Failed to fetch users"}, or {"error": "Server error"}
Example:
curl -X GET "https://stockminds.ngrok.app/api/data?type=top2" \
-H "Authorization: Bearer your-api-token"
​
Rate Limiting
The API enforces a limit of 6 requests per minute per user (based on the API token). If you exceed this limit, you’ll receive a 429 Too Many Requests response.
​
Requirements
-
Paid Subscription Plan: You must have premium, advanced, expert or elite access. You can upgrade your account here.
-
Trading Hours: Data is available Monday–Friday after 7:00 AM EDT, excluding US trading holidays.
​
Example Python Code​
​
Example Data Output
Using the above example python code, this is an example of the output:
{'MINM': {'prob': '88.9', 'entry': '3.55', 'stop': '3.43', 'profits': ['3.82', '4.08', '4.6', '5.13'], 'move': 3.54},
'CV': {'prob': '88.1', 'entry': '4.43', 'stop': '4.09', 'profits': ['4.95', '5.46', '6.49', '7.52'], 'move': 4.43}}
​
The data is provided as a dictionary with the top two Stockminds trades at that time. The keys of the dictionary are the ticker symbols with the values associated with the keys providing the trade details. Here is a breakdown:
​
'prob' – Stockminds trade probability. The likelihood of the ticker providing a profitable trade.
'entry' – Suggested entry price for the trade.
'stop' – Suggested stop loss price for the trade.
'profits' – A list of the four suggested profit prices for the trade.
'move' – The upper bound value of the predicted move down.
​
Note that if the ticker is more likely to move up at market open, the ‘entry’ value will be “Open” and the ‘move’ value will be “-“.
Currently, the only request type is “top2” which provides data for the top two highest rated Stockminds trades.
​
Support
We are always working to provide more tools and information for users. If there is specific information that you would want to be included in the API, or if you are experiencing issues, contact support at stockminds@stockminds.world. Provide your email, token (if applicable), and details of the request or issue.
​​