curl --request POST \
--url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/cancel-batch \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"orderIds": [
"<string>"
]
}
'import requests
url = "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/cancel-batch"
payload = { "orderIds": ["<string>"] }
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({orderIds: ['<string>']})
};
fetch('https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/cancel-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/cancel-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([
'orderIds' => [
'<string>'
]
]),
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/cancel-batch"
payload := strings.NewReader("{\n \"orderIds\": [\n \"<string>\"\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/cancel-batch")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"orderIds\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/cancel-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 \"orderIds\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"cancelled": [
"<string>"
],
"notCancelled": {},
"remainingQty": {}
}{
"status": 400,
"error": {
"code": "bad_request",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 404,
"error": {
"code": "<string>",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 400,
"error": {
"code": "bad_request",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 400,
"error": {
"code": "bad_request",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 404,
"error": {
"code": "<string>",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 400,
"error": {
"code": "bad_request",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}Cancel a batch of orders by id (max 100)
Cancel up to 100 orders by id in one request. Each id is resolved against the authenticated wallet; ids that are unknown, belong to another wallet, or are already terminal come back under notCancelled (no existence leak). Duplicate ids are de-duplicated. One round-trip replaces N single cancels. Not atomic: every id is decided and reported on its own, so one id failing neither aborts the request nor undoes the ids already in cancelled. Idempotent: re-cancelling a terminal order reports already_terminal. Rate limited at 5 req/sec per wallet. No KYC / deposit-tier gating — cancellation is always permitted.
curl --request POST \
--url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/cancel-batch \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"orderIds": [
"<string>"
]
}
'import requests
url = "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/cancel-batch"
payload = { "orderIds": ["<string>"] }
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({orderIds: ['<string>']})
};
fetch('https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/cancel-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/cancel-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([
'orderIds' => [
'<string>'
]
]),
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/cancel-batch"
payload := strings.NewReader("{\n \"orderIds\": [\n \"<string>\"\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/cancel-batch")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"orderIds\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/orders/cancel-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 \"orderIds\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"cancelled": [
"<string>"
],
"notCancelled": {},
"remainingQty": {}
}{
"status": 400,
"error": {
"code": "bad_request",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 404,
"error": {
"code": "<string>",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 400,
"error": {
"code": "bad_request",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 400,
"error": {
"code": "bad_request",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 404,
"error": {
"code": "<string>",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}{
"status": 400,
"error": {
"code": "bad_request",
"message": "<string>",
"trace_id": "<string>",
"retryAfterSec": 123,
"retryable": true,
"details": {}
}
}Authorizations
Partner / integrator key — format ps_live_<keyId>_<secret>. Partner keys are issued by PredictStreet; a user can also create keys bound to their own wallet from their account settings in the web app. 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
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.
^0x[a-fA-F0-9]{40}$"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3"
Body
1–100 server-side order ids (UUIDs). Duplicates are de-duplicated server-side.
1 - 100 elementsResponse
Per-id outcome split into cancelled and notCancelled, with remainingQty for each cancelled id.
Ids whose cancellation was accepted. Acceptance and effect are separate moments: the status flip and the release of the residual collateral (BUY) / ERC-1155 reservation (SELL) can follow the acceptance, so a read of the order taken right after this response can still show the pre-cancel status — poll the order rather than assuming. Each id stands on its own: another id failing does not undo it.
Map of orderId → reason for every id that was not cancelled. Reasons: not_found (unknown id, or an order owned by another wallet — no existence leak), already_terminal (already CANCELLED / FILLED / REJECTED / EXPIRED — idempotent), not_attempted (the request stopped before reaching this id and nothing was tried — retry exactly these ids), placement_unanswered (the order's own placement has not been answered yet — retry after a short delay), termination_refused (the cancel was attempted and refused for this request; re-read the order and send a fresh cancel), cancel_pending (the cancel is recorded and no answer to it is recorded yet — the same condition the single cancel answers 202 cancel_pending with Retry-After: 5. Cancel the ids named this way again after a few seconds, with a single cancel or a cancel-batch of exactly those ids — from cancel-all too: a new cancel-all is a new sweep that also cancels orders placed since. Repeating the cancel of an id is safe, cannot cancel twice, and is what completes it soonest; the platform may also complete it on its own. It does not mean the order is still open — it may have filled — so re-read the order), termination_unavailable (no verified answer on whether the cancel was recorded — re-read the order; resending the same cancel cannot cancel twice), financial_obligation_protected (a settlement this order took part in has not finished applying; usually clears within seconds — re-read the order and contact support if it persists), lock_invariant (returned only by older exchange nodes: the order's collateral bookkeeping was inconsistent; current nodes record it and cancel the order; re-read the order; the rest of the batch is unaffected), unknown (unexpected error — treat as transient and re-read the order).
Show child attributes
Show child attributes
Map of orderId → quantity still unfilled when that order was cancelled (decimal string), for exactly the ids in cancelled; {} when cancelled is empty. An upper bound, not a traded quantity: size a replacement quote from it, and book fills from the order read.
Show child attributes
Show child attributes