> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.ninjatrader.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ninjatrader.com/_mcp/server. # Create Alert POST https://demo.tradovateapi.com/v1/alert/createalert Content-Type: application/json ### Create a market-condition alert for the authenticated user. **Available to:** All authenticated users **Environments:** Demo, Live **[Rate Limit](/api/authentication#request-rate-limits-and-time-penalties):** No endpoint-specific limit Creates an `Alert` owned by the calling user. Supply the alert condition in `expression`; the server parses it before the alert is saved. When parsing succeeds, the alert is created with `status` set to `Active` and the server begins watching for the condition. The response returns the created `alert`, including its assigned `id`, which you use for later [`modifyAlert`](/api/rest-api-endpoints/alerts/modify-alert), [`dismissAlert`](/api/rest-api-endpoints/alerts/dismiss-alert), [`resetAlert`](/api/rest-api-endpoints/alerts/reset-alert), and [`deleteAlert`](/api/rest-api-endpoints/alerts/delete-alert) requests. Request fields: - `expression` (required) — the condition the alert watches for, up to 4096 characters. - `validUntil` — optional expiration time; the alert stops watching after this time. - `triggerLimits` — optional maximum number of times the alert may trigger (0–10). Once `triggeredCounter` reaches this value, the alert stops watching until it is reset. - `message` — optional text (up to 256 characters) delivered with the alert when it triggers. When the `expression` cannot be parsed, the alert is not created and the response carries a non-empty `errorText` describing the parse problem, with no `alert`. **Common Failure Scenarios** - The `expression` is malformed or references an unsupported condition, so it fails to parse. - The `expression` exceeds 4096 characters or `triggerLimits` is outside the 0–10 range. A created alert is never removed by a trigger. To stop an alert, [`dismissAlert`](/api/rest-api-endpoints/alerts/dismiss-alert) sets it to `Inactive`; to re-arm a triggered or failed alert, use [`resetAlert`](/api/rest-api-endpoints/alerts/reset-alert); to remove it, use [`deleteAlert`](/api/rest-api-endpoints/alerts/delete-alert). **Error Messages** | `errorText` | Trigger | |-------------|---------| | Non-empty `errorText` | The request failed; the field describes the reason (most commonly an `expression` that could not be parsed). | Reference: https://docs.ninjatrader.com/api/rest-api-endpoints/alerts/create-alert ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: public version: 1.0.0 paths: /alert/createalert: post: operationId: createAlert summary: Create Alert description: >- ### Create a market-condition alert for the authenticated user. **Available to:** All authenticated users **Environments:** Demo, Live **[Rate Limit](/api/authentication#request-rate-limits-and-time-penalties):** No endpoint-specific limit Creates an `Alert` owned by the calling user. Supply the alert condition in `expression`; the server parses it before the alert is saved. When parsing succeeds, the alert is created with `status` set to `Active` and the server begins watching for the condition. The response returns the created `alert`, including its assigned `id`, which you use for later [`modifyAlert`](/api/rest-api-endpoints/alerts/modify-alert), [`dismissAlert`](/api/rest-api-endpoints/alerts/dismiss-alert), [`resetAlert`](/api/rest-api-endpoints/alerts/reset-alert), and [`deleteAlert`](/api/rest-api-endpoints/alerts/delete-alert) requests. Request fields: - `expression` (required) — the condition the alert watches for, up to 4096 characters. - `validUntil` — optional expiration time; the alert stops watching after this time. - `triggerLimits` — optional maximum number of times the alert may trigger (0–10). Once `triggeredCounter` reaches this value, the alert stops watching until it is reset. - `message` — optional text (up to 256 characters) delivered with the alert when it triggers. When the `expression` cannot be parsed, the alert is not created and the response carries a non-empty `errorText` describing the parse problem, with no `alert`. **Common Failure Scenarios** - The `expression` is malformed or references an unsupported condition, so it fails to parse. - The `expression` exceeds 4096 characters or `triggerLimits` is outside the 0–10 range. A created alert is never removed by a trigger. To stop an alert, [`dismissAlert`](/api/rest-api-endpoints/alerts/dismiss-alert) sets it to `Inactive`; to re-arm a triggered or failed alert, use [`resetAlert`](/api/rest-api-endpoints/alerts/reset-alert); to remove it, use [`deleteAlert`](/api/rest-api-endpoints/alerts/delete-alert). **Error Messages** | `errorText` | Trigger | |-------------|---------| | Non-empty `errorText` | The request failed; the field describes the reason (most commonly an `expression` that could not be parsed). | tags: - Alerts parameters: - name: Authorization in: header description: Bearer authentication required: true schema: type: string responses: '200': description: AlertResponse content: application/json: schema: $ref: '#/components/schemas/AlertResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateAlert' servers: - url: https://demo.tradovateapi.com/v1 description: Demo - url: https://live.tradovateapi.com/v1 description: Live components: schemas: CreateAlert: type: object properties: expression: type: string validUntil: type: string format: date-time triggerLimits: type: integer message: type: string required: - expression title: CreateAlert AlertStatus: type: string enum: - Active - Expired - Failed - Inactive - TriggeredOut description: Active, Expired, Failed, Inactive, TriggeredOut title: AlertStatus Alert: type: object properties: id: type: integer format: int64 timestamp: type: string format: date-time userId: type: integer format: int64 status: $ref: '#/components/schemas/AlertStatus' description: Active, Expired, Failed, Inactive, TriggeredOut expression: type: string validUntil: type: string format: date-time triggerLimits: type: integer triggeredCounter: type: integer failure: type: string message: type: string required: - timestamp - userId - status - expression title: Alert AlertResponse: type: object properties: errorText: type: string description: Non-empty if the request failed alert: $ref: '#/components/schemas/Alert' title: AlertResponse securitySchemes: bearer_access_token: type: http scheme: bearer ``` ## Examples **Request** ```json { "expression": "string" } ``` **Response** ```json { "errorText": "string", "alert": { "timestamp": "2024-01-15T09:30:00Z", "userId": 1, "status": "Active", "expression": "string", "id": 1, "validUntil": "2024-01-15T09:30:00Z", "triggerLimits": 1, "triggeredCounter": 1, "failure": "string", "message": "string" } } ``` **SDK Code** ```python import requests url = "https://demo.tradovateapi.com/v1/alert/createalert" payload = { "expression": "string" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://demo.tradovateapi.com/v1/alert/createalert'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"expression":"string"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://demo.tradovateapi.com/v1/alert/createalert" payload := strings.NewReader("{\n \"expression\": \"string\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://demo.tradovateapi.com/v1/alert/createalert") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"expression\": \"string\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://demo.tradovateapi.com/v1/alert/createalert") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"expression\": \"string\"\n}") .asString(); ``` ```php request('POST', 'https://demo.tradovateapi.com/v1/alert/createalert', [ 'body' => '{ "expression": "string" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://demo.tradovateapi.com/v1/alert/createalert"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"expression\": \"string\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["expression": "string"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://demo.tradovateapi.com/v1/alert/createalert")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```