API
Stagingv2

Trading

Post an order

Place a new order on the exchange on behalf of a client account. Every field is required. The order is routed to the exchange trading system and the raw acknowledgement is returned.

POST/v2/vendor/order/post
Requires scopeorder.post
orderRef must be uniqueorderRef is a reference string your system generates for this order. Use a value you can reconcile against later; the exchange rejects duplicates.

Body parameters

ParameterDescription
orderType
string
required		Side of the order.
One of BUY, SELL.
security
string
required		Security symbol, for example SDNASDPLC.
timeInForce
string
required		Order duration, for example Day Order (DO).
accountNumber
string
required		The client's CDS account number.
brokerCode
string
required		Placing broker code, for example 0TST.
units
string
required		Quantity of units to trade.
price
string
required		Limit price in Naira.
clientName
string
required		Name on the client account.
orderRef
string
required		Unique client-generated reference for this order.

Response fields

FieldDescription
data
object
Raw acknowledgement passed through from the exchange trading system, including the assigned order number and status.
Request
curl -X POST "https://stagingmobile.nasdng.com/v2/vendor/order/post" \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "orderType": "BUY",
    "security": "SDNASDPLC",
    "timeInForce": "Day Order (DO)",
    "accountNumber": "100000001",
    "brokerCode": "0TST",
    "units": "10",
    "price": "40",
    "clientName": "JANE DOE",
    "orderRef": "ORD-20260706-0001"
  }'
const res = await fetch("https://stagingmobile.nasdng.com/v2/vendor/order/post", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "orderType": "BUY",
    "security": "SDNASDPLC",
    "timeInForce": "Day Order (DO)",
    "accountNumber": "100000001",
    "brokerCode": "0TST",
    "units": "10",
    "price": "40",
    "clientName": "JANE DOE",
    "orderRef": "ORD-20260706-0001"
  }),
});
const { data } = await res.json();
import requests

res = requests.post(
    "https://stagingmobile.nasdng.com/v2/vendor/order/post",
    json={
        "orderType": "BUY",
        "security": "SDNASDPLC",
        "timeInForce": "Day Order (DO)",
        "accountNumber": "100000001",
        "brokerCode": "0TST",
        "units": "10",
        "price": "40",
        "clientName": "JANE DOE",
        "orderRef": "ORD-20260706-0001",
    },
    headers={"Authorization": "Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx"},
)
data = res.json()
Response 200 OK
{
  "success": true,
  "message": "Order posted successfully",
  "data": {
    "OrderNo": 62841,
    "Status": "Posted",
    "Message": "Order accepted",
    "OrderRef": "ORD-20260706-0001"
  }
}