API
Bot Orders

Get a paginated list of bot orders. Because of the large amount of data that this can return, results are paginated to 100 orders per page, listed by order creation date descending. There is an optional page parameter that you can use to return a specific page. The paginated result set will also return a 'pages' array that contains information about the number of items and pages.

Auth Required: Read Orders
GET
Request
Path Params
number
optional
String
Unique identifier to retrieve a single order. If omitted, all orders will be returned
Query Parameters
bot
optional
String
Bot number to only retrieve orders for a specific bot
status
optional
String
Filter the results by a certain order status. Expected values are WORKING, FILLED, CANCELED, REJECTED, EXPIRED
from_date
optional
String
Minimum date for when order is submitted. Expected format is YYYY-MM-DD
to_date
optional
String
Maximum date for when order is submitted. Expected format is YYYY-MM-DD
page
optional
Integer
Page number
Header Parameters
API Token
required
String
Token from your Whispertrades account
Curl
Node.js
JS
Python
import requests
import json

url = "https://api.whispertrades.com/v1/bots/orders/{number}"

query = {
   'bot': 'String',
   'status': 'String',
   'from_date': 'String',
   'to_date': 'String',
   'page': 'Integer'
}
headers = {
   'Accept': 'application/json',
   'Content-Type': 'application/json',
   'Authorization': 'Bearer <API Token>'
}

response = requests.request("GET", url, headers=headers, params=query)

print(response.text)

import requests
import json

url = "https://api.whispertrades.com/v1/bots/orders/{number}"

query = {
   'bot': 'String',
   'status': 'String',
   'from_date': 'String',
   'to_date': 'String',
   'page': 'Integer'
}
headers = {
   'Accept': 'application/json',
   'Content-Type': 'application/json',
   'Authorization': 'Bearer <API Token>'
}

response = requests.request("GET", url, headers=headers, params=query)

print(response.text)
Responses
200
{
    "success": true,
    "message": "",
    "data": {
        "number": "GZH7QT03FD",
        "broker_order_number": "6270853416",
        "status": "FILLED",
        "type": "OPENING",
        "duration": "GTC",
        "bot": {
            "name": "0 DTE 10:00 CCS",
            "number": "AFKA95ZJFQ"
        },
        "is_paper": false,
        "symbol": "SPXW",
        "original_quantity": 1,
        "current_quantity": 1,
        "filled_quantity": 1,
        "order_price": "2.05",
        "fill_price": "2.15",
        "broker_fee": "1.57",
        "submitted_at": "2023-06-15T14:00:06.000000Z",
        "filled_at": "2023-06-15T14:00:07.000000Z",
        "canceled_at": null,
        "legs": [
            {
                "number": 75745,
                "type": "CALL",
                "instrument": "SPXW_061523C4410",
                "expiration_date": "2023-06-15T00:00:00.000000Z",
                "strike_price": "4410.0",
                "instruction": "SELL_TO_OPEN",
                "quantity": 1,
                "bid": "2.10",
                "mid": "2.13",
                "ask": "2.15"
            },
            {
                "number": 75747,
                "type": "CALL",
                "instrument": "SPXW_061523C4500",
                "expiration_date": "2023-06-15T00:00:00.000000Z",
                "strike_price": "4500.0",
                "instruction": "BUY_TO_OPEN",
                "quantity": 1,
                "bid": "0.00",
                "mid": "0.03",
                "ask": "0.05"
            }
        ],
        "submissions": [
            {
                "quantity": null,
                "price": "2.0500",
                "bid": "2.0000",
                "mid": null,
                "ask": "2.1500",
                "submitted_at": "2023-06-15T14:00:06.000000Z"
            }
        ],
        "fills": [
            {
                "leg_number": 75745,
                "quantity": 1,
                "price": "2.2000",
                "filled_at": "2023-06-15T14:00:07.000000Z",
                "bid": "2.1000",
                "mid": "2.1250",
                "ask": "2.1500"
            },
            {
                "leg_number": 75747,
                "quantity": 1,
                "price": "0.0500",
                "filled_at": "2023-06-15T14:00:07.000000Z",
                "bid": "0.0000",
                "mid": "0.0250",
                "ask": "0.0500"
            }
        ]
    }
}
{
    "success": true,
    "message": "",
    "data": {
        "number": "GZH7QT03FD",
        "broker_order_number": "6270853416",
        "status": "FILLED",
        "type": "OPENING",
        "duration": "GTC",
        "bot": {
            "name": "0 DTE 10:00 CCS",
            "number": "AFKA95ZJFQ"
        },
        "is_paper": false,
        "symbol": "SPXW",
        "original_quantity": 1,
        "current_quantity": 1,
        "filled_quantity": 1,
        "order_price": "2.05",
        "fill_price": "2.15",
        "broker_fee": "1.57",
        "submitted_at": "2023-06-15T14:00:06.000000Z",
        "filled_at": "2023-06-15T14:00:07.000000Z",
        "canceled_at": null,
        "legs": [
            {
                "number": 75745,
                "type": "CALL",
                "instrument": "SPXW_061523C4410",
                "expiration_date": "2023-06-15T00:00:00.000000Z",
                "strike_price": "4410.0",
                "instruction": "SELL_TO_OPEN",
                "quantity": 1,
                "bid": "2.10",
                "mid": "2.13",
                "ask": "2.15"
            },
            {
                "number": 75747,
                "type": "CALL",
                "instrument": "SPXW_061523C4500",
                "expiration_date": "2023-06-15T00:00:00.000000Z",
                "strike_price": "4500.0",
                "instruction": "BUY_TO_OPEN",
                "quantity": 1,
                "bid": "0.00",
                "mid": "0.03",
                "ask": "0.05"
            }
        ],
        "submissions": [
            {
                "quantity": null,
                "price": "2.0500",
                "bid": "2.0000",
                "mid": null,
                "ask": "2.1500",
                "submitted_at": "2023-06-15T14:00:06.000000Z"
            }
        ],
        "fills": [
            {
                "leg_number": 75745,
                "quantity": 1,
                "price": "2.2000",
                "filled_at": "2023-06-15T14:00:07.000000Z",
                "bid": "2.1000",
                "mid": "2.1250",
                "ask": "2.1500"
            },
            {
                "leg_number": 75747,
                "quantity": 1,
                "price": "0.0500",
                "filled_at": "2023-06-15T14:00:07.000000Z",
                "bid": "0.0000",
                "mid": "0.0250",
                "ask": "0.0500"
            }
        ]
    }
}
﻿
﻿
Updated 08 May 2024
Did this page help you?
Brokers
Bot Positions