Place a batch of signed orders (max 10)

curl --request POST \
  --url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "orders": [
    {
      "marketId": "NC26-BIN-83479265",
      "price": "0.42",
      "quantity": "2",
      "nonce": "<string>",
      "expiry": 0,
      "maker": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3",
      "signature": "<string>",
      "clientOrderId": "<string>",
      "type": "limit",
      "postOnly": false
    }
  ]
}
'

import requests

url = "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch"

payload = { "orders": [
        {
            "marketId": "NC26-BIN-83479265",
            "price": "0.42",
            "quantity": "2",
            "nonce": "<string>",
            "expiry": 0,
            "maker": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3",
            "signature": "<string>",
            "clientOrderId": "<string>",
            "type": "limit",
            "postOnly": False
        }
    ] }
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    orders: [
      {
        marketId: 'NC26-BIN-83479265',
        price: '0.42',
        quantity: '2',
        nonce: '<string>',
        expiry: 0,
        maker: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3',
        signature: '<string>',
        clientOrderId: '<string>',
        type: 'limit',
        postOnly: false
      }
    ]
  })
};

fetch('https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'orders' => [
        [
                'marketId' => 'NC26-BIN-83479265',
                'price' => '0.42',
                'quantity' => '2',
                'nonce' => '<string>',
                'expiry' => 0,
                'maker' => '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3',
                'signature' => '<string>',
                'clientOrderId' => '<string>',
                'type' => 'limit',
                'postOnly' => false
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch"

	payload := strings.NewReader("{\n  \"orders\": [\n    {\n      \"marketId\": \"NC26-BIN-83479265\",\n      \"price\": \"0.42\",\n      \"quantity\": \"2\",\n      \"nonce\": \"<string>\",\n      \"expiry\": 0,\n      \"maker\": \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3\",\n      \"signature\": \"<string>\",\n      \"clientOrderId\": \"<string>\",\n      \"type\": \"limit\",\n      \"postOnly\": false\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch")
  .header("X-Api-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"orders\": [\n    {\n      \"marketId\": \"NC26-BIN-83479265\",\n      \"price\": \"0.42\",\n      \"quantity\": \"2\",\n      \"nonce\": \"<string>\",\n      \"expiry\": 0,\n      \"maker\": \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3\",\n      \"signature\": \"<string>\",\n      \"clientOrderId\": \"<string>\",\n      \"type\": \"limit\",\n      \"postOnly\": false\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"orders\": [\n    {\n      \"marketId\": \"NC26-BIN-83479265\",\n      \"price\": \"0.42\",\n      \"quantity\": \"2\",\n      \"nonce\": \"<string>\",\n      \"expiry\": 0,\n      \"maker\": \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3\",\n      \"signature\": \"<string>\",\n      \"clientOrderId\": \"<string>\",\n      \"type\": \"limit\",\n      \"postOnly\": false\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

[
  {
    "orderId": "<string>",
    "filledQty": "<string>",
    "remainingQty": "<string>",
    "trades": [
      {
        "id": "<string>",
        "orderId": "<string>",
        "userWallet": "<string>",
        "marketId": "<string>",
        "price": "<string>",
        "quantity": "<string>",
        "fee": "<string>",
        "createdAt": "<string>"
      }
    ],
    "success": true,
    "code": "<string>",
    "message": "<string>",
    "clientOrderId": "<string>"
  }
]

{
  "error": {
    "code": "bad_request",
    "message": "<string>",
    "details": {},
    "trace_id": "<string>"
  },
  "status": 400
}

{
  "code": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": {
    "code": "bad_request",
    "message": "<string>",
    "details": {},
    "trace_id": "<string>"
  },
  "status": 400
}

{
  "code": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "message": "<string>",
  "details": {}
}

Orders

Place a batch of signed orders (max 10)

Submit up to 10 EIP-712-signed orders in one request. Orders are processed sequentially in array order with independent per-order outcomes — one rejected order never aborts the rest, and there is no all-or-nothing atomicity. Each entry is validated, balance-locked, and matched exactly as a single POST /api/orders/place. Per-wallet monetary limits (KYC deposit tier, responsible-gambling, partner trade caps) accumulate across the batch, so a batch can never admit more exposure than the same orders sent one at a time. Rate limited at 5 req/sec per wallet (up to 50 orders/sec). KYC deposit-tier gating applies, same as single place. Business rejects (bad signature, insufficient funds, …) come back as per-entry REJECTED results with HTTP 200; infrastructure failures (matcher / verifier / DB unavailable) fail the whole request with a 5xx. Every forwarded entry carries a clientOrderId (the server mints one when you omit it) so a 5xx is safe to retry — replays return the already-committed result via idempotency instead of placing duplicates.

POST

api

orders

place-batch

Place a batch of signed orders (max 10)

curl --request POST \
  --url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "orders": [
    {
      "marketId": "NC26-BIN-83479265",
      "price": "0.42",
      "quantity": "2",
      "nonce": "<string>",
      "expiry": 0,
      "maker": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3",
      "signature": "<string>",
      "clientOrderId": "<string>",
      "type": "limit",
      "postOnly": false
    }
  ]
}
'

import requests

url = "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch"

payload = { "orders": [
        {
            "marketId": "NC26-BIN-83479265",
            "price": "0.42",
            "quantity": "2",
            "nonce": "<string>",
            "expiry": 0,
            "maker": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3",
            "signature": "<string>",
            "clientOrderId": "<string>",
            "type": "limit",
            "postOnly": False
        }
    ] }
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    orders: [
      {
        marketId: 'NC26-BIN-83479265',
        price: '0.42',
        quantity: '2',
        nonce: '<string>',
        expiry: 0,
        maker: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3',
        signature: '<string>',
        clientOrderId: '<string>',
        type: 'limit',
        postOnly: false
      }
    ]
  })
};

fetch('https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'orders' => [
        [
                'marketId' => 'NC26-BIN-83479265',
                'price' => '0.42',
                'quantity' => '2',
                'nonce' => '<string>',
                'expiry' => 0,
                'maker' => '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3',
                'signature' => '<string>',
                'clientOrderId' => '<string>',
                'type' => 'limit',
                'postOnly' => false
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch"

	payload := strings.NewReader("{\n  \"orders\": [\n    {\n      \"marketId\": \"NC26-BIN-83479265\",\n      \"price\": \"0.42\",\n      \"quantity\": \"2\",\n      \"nonce\": \"<string>\",\n      \"expiry\": 0,\n      \"maker\": \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3\",\n      \"signature\": \"<string>\",\n      \"clientOrderId\": \"<string>\",\n      \"type\": \"limit\",\n      \"postOnly\": false\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch")
  .header("X-Api-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"orders\": [\n    {\n      \"marketId\": \"NC26-BIN-83479265\",\n      \"price\": \"0.42\",\n      \"quantity\": \"2\",\n      \"nonce\": \"<string>\",\n      \"expiry\": 0,\n      \"maker\": \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3\",\n      \"signature\": \"<string>\",\n      \"clientOrderId\": \"<string>\",\n      \"type\": \"limit\",\n      \"postOnly\": false\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/place-batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"orders\": [\n    {\n      \"marketId\": \"NC26-BIN-83479265\",\n      \"price\": \"0.42\",\n      \"quantity\": \"2\",\n      \"nonce\": \"<string>\",\n      \"expiry\": 0,\n      \"maker\": \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3\",\n      \"signature\": \"<string>\",\n      \"clientOrderId\": \"<string>\",\n      \"type\": \"limit\",\n      \"postOnly\": false\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

[
  {
    "orderId": "<string>",
    "filledQty": "<string>",
    "remainingQty": "<string>",
    "trades": [
      {
        "id": "<string>",
        "orderId": "<string>",
        "userWallet": "<string>",
        "marketId": "<string>",
        "price": "<string>",
        "quantity": "<string>",
        "fee": "<string>",
        "createdAt": "<string>"
      }
    ],
    "success": true,
    "code": "<string>",
    "message": "<string>",
    "clientOrderId": "<string>"
  }
]

{
  "error": {
    "code": "bad_request",
    "message": "<string>",
    "details": {},
    "trace_id": "<string>"
  },
  "status": 400
}

{
  "code": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": {
    "code": "bad_request",
    "message": "<string>",
    "details": {},
    "trace_id": "<string>"
  },
  "status": 400
}

{
  "code": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "message": "<string>",
  "details": {}
}

Authorizations

X-Api-Key

string

header

required

Partner / integrator key — format ps_live_<keyId>_<secret>. Issued by PredictStreet ops via the admin panel; never self-service. Never ship to a browser. multi_wallet partners must additionally send X-User-Wallet: 0x<40-hex> on every authenticated request to declare the acting wallet. See the API keys guide for scope taxonomy, partner kinds, rate limits, and rotation procedure.

Headers

X-User-Wallet

string

Required for multi_wallet partners on every authenticated request; ignored for single_wallet. Declares the acting end-user wallet for this request — drives KYC checks, balances/positions/orders attribution, rate-limit buckets, and audit. Lower-cased server-side. Missing on a multi_wallet key → 401 api_key_user_wallet_required; malformed → 401 api_key_user_wallet_invalid. The on-chain CTFExchange/Vault contracts still verify EIP-712 signer ↔ vault binding, so loosening API-layer attribution is safe by construction.

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3"

Body

application/json

orders

object[]

required

1–10 orders, each identical in shape to the single POST /api/orders/place body. Processed sequentially in array order.

Required array length: 1 - 10 elements

Show child attributes

Response

Per-order results, aligned to the request orders[] by index. Inspect each entry's success flag and status — a 200 batch can still contain REJECTED entries.

orderId

string

required

Server-side order id (UUID). Empty string when status=REJECTED.

status

enum<string>

required

Lifecycle state at the moment of response. Note: a 200 response may carry status=REJECTED together with a populated code / message — partner SDKs MUST inspect the body, not just the HTTP code (audit M5).

Available options:

PENDING,

OPEN,

FILLED,

CANCELLED,

REJECTED,

EXPIRED,

SETTLEMENT_FAILED

filledQty

string

required

Cumulative quantity filled at response time (decimal string).

remainingQty

string

required

quantity - filledQty (decimal string).

trades

object[]

required

Synchronous fills produced by IOC/FOK or aggressive LIMIT orders.

Show child attributes

success

boolean

required

true when the order was accepted (status ≠ REJECTED); false for a per-order business reject. Convenience flag over status.

code

string

Reject reason code (insufficient_balance, invalid_amounts, market_not_open, bad_signature, order_signed_with_floor_notional, position_limit_breached, …). Present when status=REJECTED. For order_signed_with_floor_notional the response body also carries a details object with signedMakerAmountWei + expectedCeilMakerAmountWei so the SDK can re-sign without recomputing the CEIL formula — see /errors/codes#order_signed_with_floor_notional-diagnostic-hints.

message

string

Human-readable explanation; pairs with code.

clientOrderId

string

Echo of the request clientOrderId (when supplied). Lets MM partners correlate the server-issued orderId to their own client-side handle without a follow-up GET /api/orders/{id}. Present on every shape (success, REJECTED, idempotent replay) when the request carried one. Also echoed on the events.order_placed and events.order_cancelled WS frames.

Introduction

Endpoints

WebSocket

Place a batch of signed orders (max 10)

Authorizations

Headers

Body

Response