Place an Equity Order

  • Available in Sandbox
  • Available in Production
  • Available to Advisors
  • Supported

Place an order to trade an equity security.



Header Required Values/Example Default
Accept Optional application/xml, application/json application/xml
Authorization Required Bearer {token}


Parameter Type Param Type Required Values/Example Default
account_id Path String Required VA000000
Account number
class Form String Required equity
The kind of order to be placed.
symbol Form String Required SPY
Security symbol to be traded.
side Form String Required buy
The side of the order. One of: buy, buy_to_cover, sell, sell_short
quantity Form String Required 10
The number of shares ordered.
type Form String Required market
The type of order to be placed. One of: market, limit, stop, stop_limit
duration Form String Required day
Time the order will remain active. One of: day, gtc, pre, post
price Form String Optional 1.00
Limit price. Required only for limit and stop_limit orders.
stop Form String Optional 1.00
Stop price. Required only for stop and stop_limit orders.

Code Example

If you're developing in the sandbox, change the hostname to
curl -X POST "{account_id}/orders" \
     -H 'Authorization: Bearer <TOKEN>' \
     -H 'Accept: application/json' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
     -d 'class=equity&symbol=SPY&side=buy&quantity=10&type=market&duration=day&price=1.00&stop=1.00'
// Version 1.8.0_31    
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpUriRequest;
import org.apache.http.client.methods.RequestBuilder;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.util.EntityUtils;


public class MainClass {
  public static void main(String[] args) throws IOException {
    final HttpUriRequest request = RequestBuilder
        .addHeader("Authorization", "Bearer <TOKEN>")
        .addHeader("Accept", "application/json")
        .addParameter("account_id", "VA000000")
        .addParameter("class", "equity")
        .addParameter("symbol", "SPY")
        .addParameter("side", "buy")
        .addParameter("quantity", "10")
        .addParameter("type", "market")
        .addParameter("duration", "day")
        .addParameter("price", "1.00")
        .addParameter("stop", "1.00")

    final HttpResponse response = HttpClientBuilder.create().build().execute(request);
    final String jsonString = EntityUtils.toString(response.getEntity());
    final JsonNode json = new ObjectMapper().readTree(jsonString);
# Version 2.5.0p0    
require 'uri'
require 'net/http'

url = URI("{account_id}/orders")

http =, url.port)
http.use_ssl = true

request =
request["Authorization"] = 'Bearer <TOKEN>'
request["Accept"] = 'application/json'
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "class=equity&symbol=SPY&side=buy&quantity=10&type=market&duration=day&price=1.00&stop=1.00"

response = http.request(request)
puts response.code
puts response.read_body
// Version go1.12      
package main

import (

func main() {
    apiUrl := "{account_id}/orders"
    data := url.Values{} 
    data.Set("class", "equity") 
    data.Set("symbol", "SPY") 
    data.Set("side", "buy") 
    data.Set("quantity", "10") 
    data.Set("type", "market") 
    data.Set("duration", "day") 
    data.Set("price", "1.00") 
    data.Set("stop", "1.00")

    u, _ := url.ParseRequestURI(apiUrl)
    urlStr := u.String()

    client := &http.Client{}
    r, _ := http.NewRequest("POST", urlStr, strings.NewReader(data.Encode()))
    r.Header.Add("Authorization", "Bearer <TOKEN>")
    r.Header.Add("Accept", "application/json")
    r.Header.Add("Content-Type", "application/x-www-form-urlencoded")
    r.Header.Add("Content-Length", strconv.Itoa(len(data.Encode())))

    resp, _ := client.Do(r)
    responseData, err := ioutil.ReadAll(resp.Body)

    if err != nil {

// Version    
using System;
using System.Net;  
using System.IO;
using System.Text;

public class MainClass {
  public static void Main (string[] args) {
    var request = (HttpWebRequest)WebRequest.Create("{account_id}/orders");
    var requestData = "class=equity&symbol=SPY&side=buy&quantity=10&type=market&duration=day&price=1.00&stop=1.00";
    var data = Encoding.ASCII.GetBytes(requestData);
    request.Method = "POST";
    request.Headers["Authorization"] = "Bearer <TOKEN>";
    request.Accept = "application/json";
    request.ContentType = "application/x-www-form-urlencoded";
    request.ContentLength = data.Length;

    using (var stream = request.GetRequestStream())
         stream.Write(data, 0, data.Length);

    var response = (HttpWebResponse)request.GetResponse();

    Console.WriteLine (response.StatusCode);
    var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
    Console.WriteLine (responseString);
// Version 10.15.2    
const request = require('request');

    method: 'post',
    url: '{account_id}/orders',
    form: {
       'account_id': 'VA000000',
       'class': 'equity',
       'symbol': 'SPY',
       'side': 'buy',
       'quantity': '10',
       'type': 'market',
       'duration': 'day',
       'price': '1.00',
       'stop': '1.00'
    headers: {
      'Authorization': 'Bearer <TOKEN>',
      'Accept': 'application/json'
  }, (error, response, body) => {
# Version 3.6.1    
import requests

response ='{account_id}/orders',
    data={'class': 'equity', 'symbol': 'SPY', 'side': 'buy', 'quantity': '10', 'type': 'market', 'duration': 'day', 'price': '1.00', 'stop': '1.00'},
    headers={'Authorization': 'Bearer <TOKEN>', 'Accept': 'application/json'}
json_response = response.json()
// Version 7.2.17-0ubuntu0.18.04.1
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, '{account_id}/orders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'class=equity&symbol=SPY&side=buy&quantity=10&type=market&duration=day&price=1.00&stop=1.00');
curl_setopt($ch, CURLOPT_POST, 1);

$headers = array();
$headers[] = 'Authorization: Bearer <TOKEN>';
$headers[] = 'Accept: application/json';
$headers[] = 'Content-Type: application/x-www-form-urlencoded';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
curl_close ($ch);
echo $http_code;
echo $result;


  "order": {
    "id": 257459,
    "status": "ok",
    "partner_id": "c4998eb7-06e8-4820-a7ab-55d9760065fb"