Tradier API

https://docs.tradier.com/
Admin
The Tradier API provides comprehensive tools for trading US-based equities and options, accessing...
Tokens:61,696
Snippets:466
Trust Score:9.5
Update:1 day ago
Show doc for...
Tokens:
Raw
### HTTP Streaming Endpoint (GET)

Source: https://docs.tradier.com/reference/http-streaming

The base URL for initiating an HTTP streaming session. Use GET or POST to start a stream; GET is more concise and allows a shorter list of symbols, while POST supports a longer list.

```http
GET https://stream.tradier.com/v1/markets/events
```

--------------------------------

### GET /v1/user/profile

Source: https://docs.tradier.com/docs/authentication

Example API request using the access token. Demonstrates how to include the access token in the Authorization header.

```APIDOC
## GET /v1/user/profile

### Description
Example API request using the access token. Demonstrates how to include the access token in the Authorization header.

### Method
GET

### Endpoint
https://api.tradier.com/v1/user/profile

### Authentication
Bearer Token (access token)

### Headers
- **Authorization**: Bearer {access_token}
- **Accept**: application/json

### Request Example
curl -X GET "https://api.tradier.com/v1/user/profile" \
     -H 'Authorization: Bearer <TOKEN>' \
     -H 'Accept: application/json'
```

--------------------------------

### Get User Profile - cURL Example

Source: https://docs.tradier.com/docs/account-details

Example cURL command to call the user profile endpoint with the required headers.

```bash
curl -X GET "https://api.tradier.com/v1/user/profile" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

--------------------------------

### HTTP Streaming Return Example

Source: https://docs.tradier.com/reference/http-streaming

Example payloads returned for different market events: quote, trade, summary, timesale, and tradex. Each event has a distinct structure.

```json
{
  "type": "quote",
  "symbol": "SPY",
  "bid": 281.84,
  "bidsz": 60,
  "bidexch": "M",
  "biddate": "1557757189000",
  "ask": 281.85,
  "asksz": 6,
  "askexch": "Z",
  "askdate": "1557757190000"
}
{
  "type": "trade",
  "symbol": "SPY",
  "exch": "J",
  "price": "281.85",
  "size": "100",
  "cvol": "27978993",
  "date": "1557757190000",
  "last": "281.85"
}
{
  "type": "summary",
  "symbol": "SPY",
  "open": "282.42",
  "high": "283.49",
  "low": "281.07",
  "prevClose": "288.1"
}
{
  "type": "timesale",
  "symbol": "SPY",
  "exch": "Q",
  "bid": "282.08",
  "ask": "282.09",
  "last": "282.09",
  "size": "100",
  "date": "1557758874355",
  "seq": 352795,
  "flag": "",
  "cancel": false,
  "correction": false,
  "session": "normal"
}
{
  "type": "tradex",
  "symbol": "SPY",
  "exch": "J",
  "price": "281.85",
  "size": "100",
  "cvol": "27978993",
  "date": "1557757190000",
  "last": "281.85"
}
```

--------------------------------

### Example JSON Response for Order Preview

Source: https://docs.tradier.com/docs/trading

Example response from the Place Order endpoint when previewing an order. Shows the order status, commission, cost, fees, margin change, and other order details.

```json
{
  "order": {
    "status": "ok",
    "commission": 0,
    "cost": 2613.8,
    "fees": 0,
    "symbol": "AAPL",
    "quantity": 10,
    "side": "buy",
    "type": "market",
    "duration": "day",
    "result": true,
    "order_cost": 2613.8,
    "margin_change": 1306.9,
    "request_date": "2026-02-20T03:45:14.714",
    "extended_hours": false,
    "class": "equity",
    "strategy": "equity",
    "day_trades": 0
  }
}
```

--------------------------------

### Return example: JSON payloads for quote, trade, summary, timesale

Source: https://docs.tradier.com/reference/http-streaming

Example response payloads from the streaming endpoint, showing JSON objects for quote, trade, summary, and timesale events.

```json
{
  "type": "quote",
  "symbol": "SPY",
  "bid": 281.84,
  "bidsz": 60,
  "bidexch": "M",
  "biddate": "1557757189000",
  "ask": 281.85,
  "asksz": 6,
  "askexch": "Z",
  "askdate": "1557757190000"
}
{
  "type": "trade",
  "symbol": "SPY",
  "exch": "J",
  "price": "281.85",
  "size": "100",
  "cvol": "27978993",
  "date": "1557757190000",
  "last": "281.85"
}
{
  "type": "summary",
  "symbol": "SPY",
  "open": "282.42",
  "high": "283.49",
  "low": "281.07",
  "prevClose": "288.1"
}
{
  "type": "timesale",
  "symbol": "SPY",
  "exch": "Q",
  "bid": "282.08",
  "ask": "282.09",
  "last": "282.09",
  "size": "100",
  "date": "1557758874355",
  "seq": 352795,
  "flag": "",
  "cancel": false,
  "correction": false,
  "session": "normal"
}
```

--------------------------------

### Get all watchlists - JSON response

Source: https://docs.tradier.com/docs/watchlists

Example response for the 'Watchlists' endpoint. Shows the structure with an array of watchlists, each containing name, id, and public_id.

```json
{
   "watchlists":{
      "watchlist":[
         {
            "name":"default",
            "id":"default",
            "public_id":"public-atea42pd"
         },
         {
            "name":"a c d",
            "id":"a-c-d",
            "public_id":"public-5672lg0a"
         }
      ]
   }
}
```

--------------------------------

### Install Claude Code via Homebrew

Source: https://docs.tradier.com/docs/tradier-mcp

Install the Claude Code CLI using Homebrew. This is the first step before adding the Tradier MCP server.

```bash
brew install --cask claude-code
```

--------------------------------

### Get Account Balance - Bash curl

Source: https://docs.tradier.com/docs/account-details

Example curl command to fetch account balances. Replace 6YA000001 with your account ID and <YOUR_TOKEN> with your access token.

```bash
curl -X GET "https://api.tradier.com/v1/accounts/6YA000001/balances" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

--------------------------------

### Multileg order request example

Source: https://docs.tradier.com/reference/trading

Example of a properly composed multileg order (spread) using form-parameter notation with side[index], quantity[index], and option_symbol[index]. The request is a POST to /v1/accounts/12345678/orders with class=multileg, symbol=CSCO, duration=day, type=market, and two legs: buy_to_open and sell_to_open.

```http
POST /v1/accounts/12345678/orders HTTP/1.1 
Host: api.tradier.com 
Accept: _/_

class=multileg&symbol=CSCO&duration=day&type=market 
&side\[0\]=buy\_to\_open&quantity\[0\]=1&option\_symbol\[0\]=CSCO150117C00035000 
&side\[1\]=sell\_to\_open&quantity\[1\]=1&option\_symbol\[1\]=CSCO140118C00008000
```

--------------------------------

### Time and Sales Response Example

Source: https://docs.tradier.com/docs/timesale

Example output from running the timesales Python module, showing a JSON response with a series of data points. Each data point includes time, timestamp, price, open, high, low, close, volume, and vwap fields.

```json
timmcmacken@Tims-MacBook-Pro Python scripts % python3 -m timesales
{
  "series": {
    "data": [
      {
        "time": "2025-07-01T09:30:00",
        "timestamp": 1751376600,
        "price": 207.26004999999998,
        "open": 206.72,
        "high": 208.38,
        "low": 206.1401,
        "close": 207.53,
        "volume": 9876387,
        "vwap": 207.32529
      },
      {
        "time": "2025-07-01T09:45:00",
        "timestamp": 1751377500,
        "price": 208.29500000000002,
        "open": 207.53,
        "high": 209.11,
        "low": 207.48,
        "close": 209.0848,
        "volume": 6249782,
        "vwap": 208.49322
      },
      {
        "time": "2025-07-01T10:00:00",
        "timestamp": 1751378400,
        "price": 209.12,
        "open": 209.06,
        "high": 209.68,
        "low": 208.56,
        "close": 209.66,
        "volume": 4434833,
        "vwap": 209.1358
      }
    ]
  }
}
```

--------------------------------

### Get Account Positions - Bash curl

Source: https://docs.tradier.com/docs/account-details

Example curl command to fetch account positions. Replace 6YA000001 with your account ID and <YOUR_TOKEN> with your access token.

```bash
curl -X GET "https://api.tradier.com/v1/accounts/6YA000001/positions" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

--------------------------------

### Python HTTP Streaming Example

Source: https://docs.tradier.com/reference/http-streaming

Python example using requests to stream market events. Requires a valid sessionid and symbols. The stream is initiated with stream=True and lines are parsed as JSON.

```python
import json
import requests

headers = {
  'Accept': 'application/json'
}

payload = { 
  'sessionid': 'SESSION_ID',
  'symbols': 'SPY',
  'linebreak': True
}

r = requests.get('https://stream.tradier.com/v1/markets/events', stream=True, params=payload, headers=headers)
for line in r.iter_lines():
  if line:
    print(json.loads(line))
```

--------------------------------

### Get Historical Account Balances - Bash curl

Source: https://docs.tradier.com/docs/account-details

Example curl command to fetch historical balances for a month. Replace 6YA000001 with your account ID and <YOUR_TOKEN> with your access token.

```bash
curl -X GET "https://api.tradier.com/v1/accounts/6YA000001/history?period=MONTH" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

--------------------------------

### Get Account Gain/Loss - cURL Example

Source: https://docs.tradier.com/docs/account-details

cURL command to retrieve gain/loss data for a specific account. Replace <YOUR_TOKEN> with a valid bearer token. The response includes cost basis, proceeds, and realized P&L for each closed position.

```bash
curl -X GET "https://api.tradier.com/v1/accounts/6YA000001/gainloss" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

--------------------------------

### Get Account History - curl

Source: https://docs.tradier.com/docs/account-details

Retrieves detailed historical transaction activity for an account, including trades, dividends, ACH transfers, fees, and interest. This example filters by type 'trade', start date '2025-01-01', and limit 50. Note: not available for sandbox/paper trading accounts.

```bash
curl -X GET "https://api.tradier.com/v1/accounts/6YA000001/history?type=trade&start=2025-01-01&limit=50" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

--------------------------------

### Recommended Workflow

Source: https://docs.tradier.com/docs/trading

Describes the recommended pattern for placing orders: preview with preview=true, submit with preview=false, poll order status, and cancel or modify while open.

```APIDOC
## Recommended Workflow

### Description
For most integrations, follow this pattern for any order.

### Steps
1. **Preview** the order with `preview=true` to validate parameters and see costs.
2. If `result: true`, **submit** the same payload with `preview=false`.
3. **Poll** `GET /v1/accounts/{account_id}/orders/{order_id}` to monitor status — confirm it reaches `open`, `partially_filled`, or `filled` rather than `rejected` or `canceled`.
4. **Cancel or modify** as needed while the order is still open.
```

--------------------------------

### Get a specific watchlist - JSON response

Source: https://docs.tradier.com/docs/watchlists

Example response for the 'Get a specific watchlist' endpoint. Shows the structure with watchlist name, id, public_id, and an array of items with symbol and id.

```json
{
   "watchlist":{
      "name":"default",
      "id":"default",
      "public_id":"public-atea42pd",
      "items":{
         "item":[
            {
               "symbol":"AAPL",
               "id":"aapl"
            },
            {
               "symbol":"AMZN",
               "id":"amzn"
            }
         ]
      }
   }
}
```

--------------------------------

### Preview an Order with curl (preview=true)

Source: https://docs.tradier.com/docs/trading

Submit a full order payload to the Place Order endpoint with preview=true to validate the order and see estimated costs, commissions, and margin impact. All standard validation rules, including buying power checks, run against the preview. Previewing is recommended but not strictly required.

```bash
curl -X POST "https://api.tradier.com/v1/accounts/6YA00001/orders" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "class=equity&symbol=AAPL&side=buy&quantity=10&type=market&duration=day&preview=true"
```

--------------------------------

### Get All Position Groups - cURL Example

Source: https://docs.tradier.com/docs/account-details

cURL command to retrieve all position groups for a specific account. Replace <YOUR_TOKEN> with a valid bearer token.

```bash
# Example: Get all position groups
curl -X GET "https://api.tradier.com/v1/accounts/6YA000001/position-groups" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

--------------------------------

### GET /v1/markets/history

Source: https://docs.tradier.com/reference/brokerage-api-markets-get-history

Retrieves historical pricing data for a specified security symbol. Supports optional interval, start date, and end date parameters.

```APIDOC
## GET /v1/markets/history

### Description
Get historical pricing for a specific security. This data will usually cover the entire lifetime of the company if sending reasonable start/end times. You can fetch historical pricing for options by passing the OCC option symbol (ex. AAPL220617C00270000) as the symbol.

### Method
GET

### Endpoint
https://api.tradier.com/v1/markets/history

### Parameters
#### Query Parameters
- **symbol** (string) - Required - The security symbol
- **interval** (string, enum) - Optional - The interval for the data. Allowed: `daily`, `weekly`, `monthly`. Defaults to daily.
- **start** (date) - Optional - The start date for the data (YYYY-MM-DD)
- **end** (date) - Optional - The end date for the data (YYYY-MM-DD)

### Response
#### Success Response (200)
Historical pricing data

#### Error Responses
- **400** - Invalid request parameters or body
- **401** - Authentication required or invalid credentials

```

--------------------------------

### Preview an order with curl using preview=true

Source: https://docs.tradier.com/reference/trading

Use this curl command to preview an order by sending a POST request to the Tradier Create Order endpoint with the preview=true parameter. The response includes validation issues, warnings, and commission information. All order validation rules, including buying power checks, are run during preview.

```bash
curl --request POST \
     --url https://api.tradier.com/v1/accounts/6YA00005/orders \
     --header 'Content-Type: application/x-www-form-urlencoded' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer abcdefghijklmnopqrstuvwxyz0123456789' \
     --data type=market \
     --data duration=day \
     --data class=equity \
     --data symbol=AAPL \
     --data quantity=1 \
     --data side=buy \
     --data preview=true
```

--------------------------------

### Node.js WebSocket account data streaming

Source: https://docs.tradier.com/reference/websocket-account-data-streaming

Node.js example using the 'ws' library to connect and send subscription commands. Logs connection, messages, and errors.

```javascript
const WebSocket = require('ws');
const ws = new WebSocket('wss://ws.tradier.com/v1/accounts/events');

ws.on('open', function open() {
  console.log('Connected, sending subscription commands...');
  ws.send('{"events": ["order"], "sessionid": "SESSION_ID", "excludeAccounts": []}');
});
ws.on('message', function incoming(data) {
  console.log(data);
});
ws.on('error', function error(data) {
  console.log(data);
});
```

--------------------------------

### Get All Position Groups - HTTP Request

Source: https://docs.tradier.com/docs/account-details

HTTP GET request to retrieve all position groups for an account.

```http
GET /v1/accounts/{account_id}/position-groups
```

--------------------------------

### GET /v1/accounts/{account_id}/position-groups

Source: https://docs.tradier.com/docs/account-details

Get all position groups for the account. Position groups let you logically organize related positions together.

```APIDOC
## GET /v1/accounts/{account_id}/position-groups

### Description
Get all position groups for the account. Position groups let you logically organize related positions together.

### Method
GET

### Endpoint
/v1/accounts/{account_id}/position-groups

### Parameters
#### Path Parameters
- **account_id** (string) - Required - The account identifier.

### Request Example
```bash
curl -X GET "https://api.tradier.com/v1/accounts/6YA000001/position-groups" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

### Response
#### Success Response (200)
Returns a list of position groups.

```

--------------------------------

### Python example: streaming market events with requests

Source: https://docs.tradier.com/reference/http-streaming

Python code using requests to POST to the streaming endpoint with sessionid, symbols, and linebreak parameters. It iterates over response lines to process streamed data.

```python
import json
import requests

headers = {
  'Accept': 'application/json'
}

payload = { 
  'sessionid': 'SESSION_ID',
  'symbols': 'SPY',
  'linebreak': True
}

r = requests.post('https://stream.tradier.com/v1/markets/events', stream=True, params=payload, headers=headers)
for line in r.iter_lines():
  if line:
```

--------------------------------

### POST /v1/accounts/{account_id}/orders (Pre/Post Market Session Order)

Source: https://docs.tradier.com/docs/trading

Places an equity order during pre-market or post-market session by setting duration=pre or duration=post. The example shows a limit buy order for AAPL in the pre-market session.

```APIDOC
## POST /v1/accounts/{account_id}/orders

### Description
Places an equity order during pre-market or post-market session by setting duration=pre or duration=post. The example shows a limit buy order for AAPL in the pre-market session.

### Method
POST

### Endpoint
https://api.tradier.com/v1/accounts/{account_id}/orders

### Parameters
#### Path Parameters
- **account_id** (string) - Required - The account identifier (e.g., 6YA00001).

#### Request Body (application/x-www-form-urlencoded)
- **class** (string) - Required - Must be "equity".
- **symbol** (string) - Required - The equity symbol (e.g., AAPL).
- **side** (string) - Required - Order side: buy or sell.
- **quantity** (number) - Required - Number of shares.
- **type** (string) - Required - Order type: limit, market, etc.
- **duration** (string) - Required - Session: "pre" for pre-market (7:00 AM – 9:24 AM EST) or "post" for post-market (4:00 PM – 7:55 PM EST).
- **price** (number) - Required for limit orders - Limit price.

### Request Example
```bash
curl -X POST "https://api.tradier.com/v1/accounts/6YA00001/orders" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "class=equity&symbol=AAPL&side=buy&quantity=10&type=limit&duration=pre&price=174.50"
```

### Response
No response schema provided in the source.

```

--------------------------------

### GET /v1/markets/events

Source: https://docs.tradier.com/reference/http-streaming

Stream market updates using HTTP streaming. You will receive a different payload depending on the market event that occurred. Use GET for a concise list of symbols.

```APIDOC
## GET /v1/markets/events

### Description
Stream market updates using HTTP streaming. You will receive a different payload depending on the market event that occurred. Use GET for a concise list of symbols.

### Method
GET

### Endpoint
https://stream.tradier.com/v1/markets/events

### Parameters
#### Query Parameters
- **symbols** (String) - Required - Comma-separated list of symbols to stream. Example: "AAPL, TSLA250815C00150000"
- **sessionid** (String) - Required - The session ID obtained from creating a streaming session. Example: "9D1C7018CFEB6F8ECF8CAA58B33"
- **filter** (String) - Optional - Comma-separated list of event types to receive. Values: "trade,quote,summary,timesale,tradex". Default: All payloads.
- **linebreak** (String) - Optional - If "true", each event is returned on a new line. Default: "false".
- **validOnly** (String) - Optional - If "true", only valid data is returned. Default: "true".
- **advancedDetails** (String) - Optional - If "true", additional details are included. Default: "false".

### Headers
- **Accept** (Optional) - Values: application/json, application/xml. Default: application/xml.
- **Authorization** (Required) - Format: Bearer <API TOKEN>.

### Request Example
```
import json
import requests

headers = {
  'Accept': 'application/json'
}

payload = { 
  'sessionid': 'SESSION_ID',
  'symbols': 'SPY',
  'linebreak': True
}

r = requests.get('https://stream.tradier.com/v1/markets/events', stream=True, params=payload, headers=headers)
for line in r.iter_lines():
  if line:
    print(json.loads(line))
```

### Response
#### Success Response (200)
The response is a stream of JSON objects, each representing a market event. The type field indicates the event type: quote, trade, summary, timesale, or tradex.

#### Response Example
```
{
  "type": "quote",
  "symbol": "SPY",
  "bid": 281.84,
  "bidsz": 60,
  "bidexch": "M",
  "biddate": "1557757189000",
  "ask": 281.85,
  "asksz": 6,
  "askexch": "Z",
  "askdate": "1557757190000"
}
{
  "type": "trade",
  "symbol": "SPY",
  "exch": "J",
  "price": "281.85",
  "size": "100",
  "cvol": "27978993",
  "date": "1557757190000",
  "last": "281.85"
}
{
  "type": "summary",
  "symbol": "SPY",
  "open": "282.42",
  "high": "283.49",
  "low": "281.07",
  "prevClose": "288.1"
}
{
  "type": "timesale",
  "symbol": "SPY",
  "exch": "Q",
  "bid": "282.08",
  "ask": "282.09",
  "last": "282.09",
  "size": "100",
  "date": "1557758874355",
  "seq": 352795,
  "flag": "",
  "cancel": false,
  "correction": false,
  "session": "normal"
}
{
  "type": "tradex",
  "symbol": "SPY",
  "exch": "J",
  "price": "281.85",
  "size": "100",
  "cvol": "27978993",
  "date": "1557757190000",
  "last": "281.85"
}
```

```

--------------------------------

### GET /v1/markets/calendar

Source: https://docs.tradier.com/reference/brokerage-api-markets-get-calendar

Get the market calendar for the current or a specified month. This endpoint requires authentication via Bearer token and supports optional month and year query parameters.

```APIDOC
## GET /v1/markets/calendar

### Description
Get the market calendar for current or a specific month.

### Method
GET

### Endpoint
https://api.tradier.com/v1/markets/calendar

### Parameters
#### Query Parameters
- **month** (integer) - Optional - The calendar month (1-12)
- **year** (integer) - Optional - The calendar year (2000-2050)

### Response
#### Success Response (200)
Market calendar

#### Error Response (401)
Authentication required or invalid credentials

```

--------------------------------

### POST /v1/accounts/{account_id}/orders (Option Order - Buy to Open)

Source: https://docs.tradier.com/docs/trading

Places a single-leg option order to buy a call option to open. Requires the full OCC option symbol and side=buy_to_open.

```APIDOC
## POST /v1/accounts/{account_id}/orders

### Description
Places a single-leg option order to buy a call option to open. Requires the full OCC option symbol and side=buy_to_open.

### Method
POST

### Endpoint
https://api.tradier.com/v1/accounts/{account_id}/orders

### Parameters
#### Path Parameters
- **account_id** (string) - Required - The account identifier (e.g., 6YA00001).

#### Request Body (application/x-www-form-urlencoded)
- **class** (string) - Required - Must be "option".
- **symbol** (string) - Required - The underlying symbol (e.g., AAPL).
- **option_symbol** (string) - Required - Full OCC option symbol (e.g., AAPL251017C00247500).
- **side** (string) - Required - Option side: buy_to_open, sell_to_open, buy_to_close, sell_to_close.
- **quantity** (number) - Required - Number of contracts.
- **type** (string) - Required - Order type: market, limit, etc.
- **duration** (string) - Required - Order duration: day, etc.

### Request Example
```bash
curl -X POST "https://api.tradier.com/v1/accounts/6YA00001/orders" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "class=option&symbol=AAPL&option_symbol=AAPL251017C00247500&side=buy_to_open&quantity=1&type=market&duration=day"
```

### Response
No response schema provided in the source.

```

--------------------------------

### Buy a Call Option to Open with curl

Source: https://docs.tradier.com/docs/trading

Place a single-leg options order using the full OCC option symbol (e.g., AAPL251017C00247500). The side must be one of buy_to_open, sell_to_open, buy_to_close, or sell_to_close; this example uses buy_to_open with a market order.

```bash
curl -X POST "https://api.tradier.com/v1/accounts/6YA00001/orders" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "class=option&symbol=AAPL&option_symbol=AAPL251017C00247500&side=buy_to_open&quantity=1&type=market&duration=day"
```

--------------------------------

### POST /v1/markets/events

Source: https://docs.tradier.com/reference/http-streaming

Establishes a streaming connection to receive real-time market events. Requires an active session ID and a list of symbols. Optional filters allow selecting specific event types and enabling line breaks or advanced details.

```APIDOC
## POST /v1/markets/events

### Description
Establishes a streaming connection to receive real-time market events such as quotes, trades, summaries, and timesales. Requires an active session ID and a list of symbols.

### Method
POST

### Endpoint
https://stream.tradier.com/v1/markets/events

### Headers
- **Accept** (string) - Optional - Response format: application/json or application/xml. Default: application/xml.
- **Authorization** (string) - Required - Bearer token for authentication. Format: Bearer <API TOKEN>.

### Parameters
#### Form Parameters
- **symbols** (string) - Required - Comma-separated list of symbols (e.g., "AAPL, TSLA250815C00150000").
- **sessionid** (string) - Required - Session identifier (e.g., "9D1C7018CFEB6F8ECF8CAA58B33").
- **filter** (string) - Optional - Comma-separated list of event types to receive: trade, quote, summary, timesale, tradex. Default: all payloads.
- **linebreak** (string) - Optional - Set to "true" to receive line breaks. Default: "false".
- **validOnly** (string) - Optional - Set to "true" to receive only valid data. Default: "true".
- **advancedDetails** (string) - Optional - Set to "true" to receive advanced details. Default: "false".

### Request Example
```python
import json
import requests

headers = {
  'Accept': 'application/json'
}

payload = { 
  'sessionid': 'SESSION_ID',
  'symbols': 'SPY',
  'linebreak': True
}

r = requests.post('https://stream.tradier.com/v1/markets/events', stream=True, params=payload, headers=headers)
for line in r.iter_lines():
  if line:
    print(line)
```

### Response
#### Success Response (200)
The response is a stream of JSON objects, each representing a market event. The event type is indicated by the "type" field.

#### Response Example
```json
{
  "type": "quote",
  "symbol": "SPY",
  "bid": 281.84,
  "bidsz": 60,
  "bidexch": "M",
  "biddate": "1557757189000",
  "ask": 281.85,
  "asksz": 6,
  "askexch": "Z",
  "askdate": "1557757190000"
}
{
  "type": "trade",
  "symbol": "SPY",
  "exch": "J",
  "price": "281.85",
  "size": "100",
  "cvol": "27978993",
  "date": "1557757190000",
  "last": "281.85"
}
{
  "type": "summary",
  "symbol": "SPY",
  "open": "282.42",
  "high": "283.49",
  "low": "281.07",
  "prevClose": "288.1"
}
{
  "type": "timesale",
  "symbol": "SPY",
  "exch": "Q",
  "bid": "282.08",
  "ask": "282.09",
  "last": "282.09",
  "size": "100",
  "date": "1557758874355",
  "seq": 352795,
  "flag": "",
  "cancel": false,
  "correction": false,
  "session": "normal"
}
```

```

--------------------------------

### Get Account Gain/Loss - HTTP Request

Source: https://docs.tradier.com/docs/account-details

HTTP GET request to retrieve cost basis and realized gain/loss for all closed positions. Supports optional 'page' and 'limit' parameters for pagination. Data is updated nightly.

```http
GET /v1/accounts/{account_id}/gainloss
```

--------------------------------

### Next Steps

Source: https://docs.tradier.com/docs/trading

Points to related API endpoints for market data, account information, and streaming data.

```APIDOC
## Next Steps

### Description
Related resources for further integration.

### Related Endpoints
- **Market Data** — Look up option chains, quotes, and expirations before placing trades at `GET /v1/markets/...`
- **Account Endpoints** — Check buying power and positions before sizing orders
- **Streaming** — Subscribe to real-time account events to get live order fill notifications
```

--------------------------------

### Python WebSocket account data streaming

Source: https://docs.tradier.com/reference/websocket-account-data-streaming

Python example using the websockets library to connect and consume account events. Sends a payload with events, sessionid, and excludeAccounts, then prints responses.

```python
import asyncio
import websockets

async def connect_and_consume():
  uri = "wss://ws.tradier.com/v1/accounts/events"
  async with websockets.connect(uri) as websocket:
    payload = '{"events": ["order"], "sessionid": "SESSION_ID", "excludeAccounts": []}'

    await websocket.send(payload)
    print(f"> {payload}")

    while True:
      response = await websocket.recv()
      print(f"< {response}")

asyncio.get_event_loop().run_until_complete(connect_and_consume())
```

--------------------------------

### Ruby WebSocket account data streaming

Source: https://docs.tradier.com/reference/websocket-account-data-streaming

Ruby example using faye-websocket and eventmachine. Connects to the endpoint and sends the subscription payload on open.

```ruby
require 'faye/websocket'
require 'eventmachine'
    
EM.run do
  ws = Faye::WebSocket::Client.new('wss://ws.tradier.com/v1/accounts/events')
    
  ws.on :open do |event|
    puts :open
    ws.send('{"events": ["order"], "sessionid": "SESSION_ID", "excludeAccounts": []}')
  end
  
  ws.on :message do |event|
    puts event.data 
  end
    
  ws.on :close do |event|
    puts :close, event.code, event.reason
    ws = nil
  end
end
```
Tokens:
Raw