> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://partner.ninjatrader.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://partner.ninjatrader.com/_mcp/server. # Expire Market Data Subscription POST https://live.tradovateapi.com/v1/user/expiremarketdatasubscription Content-Type: application/json ### Expire market data subscriptions for users. **Available to:** Organization administrators This endpoint allows you to immediately archive and expire up to 100 market data subscriptions in a single request, helping you manage multiple subscriptions at once. The subscription IDs are primary keys from the `marketDataSubscriptions` database table and are returned when subscriptions are created using endpoints like [`addMarketDataSubscription`](/api/rest-api-endpoints/users/add-market-data-subscription). If some subscriptions fail to expire while others succeed, the response will include both `successfulSubscriptionIdExpiries` and `failedSubscriptionIdExpiries` arrays, allowing you to identify which subscriptions were processed successfully and which encountered errors. **Common failure scenarios:** - Providing a nonexistent subscription ID - Providing an ID for a subscription belonging to a user not in your organization - Providing more than 100 IDs in a single request If you accidentally expire a subscription, you can create a new subscription for the user using [`addMarketDataSubscription`](/api/rest-api-endpoints/users/add-market-data-subscription). **Error Codes:** | Error Code | Description | |------------|-------------| | `0` | `UsersNotInOrganization` - One or more subscription IDs belong to users not in your organization | | `1` | `TooManySubscriptions` - More than 100 subscription IDs were provided in the request | | `2` | `InternalError` - An internal processing error occurred | Reference: https://partner.ninjatrader.com/connect/api/rest-api-endpoints/users/expire-market-data-subscription ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: connect version: 1.0.0 paths: /user/expiremarketdatasubscription: post: operationId: expire-market-data-subscription summary: Expire Market Data Subscription description: >- ### Expire market data subscriptions for users. **Available to:** Organization administrators This endpoint allows you to immediately archive and expire up to 100 market data subscriptions in a single request, helping you manage multiple subscriptions at once. The subscription IDs are primary keys from the `marketDataSubscriptions` database table and are returned when subscriptions are created using endpoints like [`addMarketDataSubscription`](/api/rest-api-endpoints/users/add-market-data-subscription). If some subscriptions fail to expire while others succeed, the response will include both `successfulSubscriptionIdExpiries` and `failedSubscriptionIdExpiries` arrays, allowing you to identify which subscriptions were processed successfully and which encountered errors. **Common failure scenarios:** - Providing a nonexistent subscription ID - Providing an ID for a subscription belonging to a user not in your organization - Providing more than 100 IDs in a single request If you accidentally expire a subscription, you can create a new subscription for the user using [`addMarketDataSubscription`](/api/rest-api-endpoints/users/add-market-data-subscription). **Error Codes:** | Error Code | Description | |------------|-------------| | `0` | `UsersNotInOrganization` - One or more subscription IDs belong to users not in your organization | | `1` | `TooManySubscriptions` - More than 100 subscription IDs were provided in the request | | `2` | `InternalError` - An internal processing error occurred | tags: - subpackage_users parameters: - name: Authorization in: header description: Bearer authentication required: true schema: type: string responses: '200': description: ExpireMarketDataSubscriptionResponse content: application/json: schema: $ref: '#/components/schemas/ExpireMarketDataSubscriptionResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/ExpireMarketDataSubscription' servers: - url: https://live.tradovateapi.com/v1 description: https://live.tradovateapi.com/v1 components: schemas: ExpireMarketDataSubscription: type: object properties: marketDataSubscriptionIds: type: array items: type: integer format: int64 required: - marketDataSubscriptionIds title: ExpireMarketDataSubscription ExpireMarketDataSubscriptionResponseErrorCode: type: string enum: - InternalError - TooManySubscriptions - UsersNotInOrganization description: InternalError, TooManySubscriptions, UsersNotInOrganization title: ExpireMarketDataSubscriptionResponseErrorCode ExpireMarketDataSubscriptionResponse: type: object properties: errorText: type: string description: Non-empty if the request failed ok: type: boolean errorCode: $ref: '#/components/schemas/ExpireMarketDataSubscriptionResponseErrorCode' description: InternalError, TooManySubscriptions, UsersNotInOrganization failedSubscriptionIdExpiries: type: array items: type: integer format: int64 successfulSubscriptionIdExpiries: type: array items: type: integer format: int64 required: - ok - failedSubscriptionIdExpiries - successfulSubscriptionIdExpiries title: ExpireMarketDataSubscriptionResponse securitySchemes: bearer_access_token: type: http scheme: bearer ``` ## Examples **Request** ```json { "marketDataSubscriptionIds": [ 1001, 1002, 1003, 1004, 1005 ] } ``` **Response** ```json { "ok": true, "failedSubscriptionIdExpiries": [], "successfulSubscriptionIdExpiries": [ 1001, 1002, 1003, 1004, 1005 ], "errorText": "", "errorCode": "InternalError" } ``` **SDK Code** ```python import requests url = "https://live.tradovateapi.com/v1/user/expiremarketdatasubscription" payload = { "marketDataSubscriptionIds": [1001, 1002, 1003, 1004, 1005] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://live.tradovateapi.com/v1/user/expiremarketdatasubscription'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"marketDataSubscriptionIds":[1001,1002,1003,1004,1005]}' }; 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://live.tradovateapi.com/v1/user/expiremarketdatasubscription" payload := strings.NewReader("{\n \"marketDataSubscriptionIds\": [\n 1001,\n 1002,\n 1003,\n 1004,\n 1005\n ]\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://live.tradovateapi.com/v1/user/expiremarketdatasubscription") 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 \"marketDataSubscriptionIds\": [\n 1001,\n 1002,\n 1003,\n 1004,\n 1005\n ]\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://live.tradovateapi.com/v1/user/expiremarketdatasubscription") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"marketDataSubscriptionIds\": [\n 1001,\n 1002,\n 1003,\n 1004,\n 1005\n ]\n}") .asString(); ``` ```php request('POST', 'https://live.tradovateapi.com/v1/user/expiremarketdatasubscription', [ 'body' => '{ "marketDataSubscriptionIds": [ 1001, 1002, 1003, 1004, 1005 ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://live.tradovateapi.com/v1/user/expiremarketdatasubscription"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"marketDataSubscriptionIds\": [\n 1001,\n 1002,\n 1003,\n 1004,\n 1005\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["marketDataSubscriptionIds": [1001, 1002, 1003, 1004, 1005]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://live.tradovateapi.com/v1/user/expiremarketdatasubscription")! 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() ```