Allocate a block order's fills across portfolios
POST
/orders/{id}/allocations
curl --request POST \ --url http://localhost:3001/orders/00000000-0000-0000-0000-000000000000/allocations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{"splits":[{"portfolio_id":"00000000-0000-0000-0000-000000000000","qty":0}]}'import requests
url = "http://localhost:3001/orders/00000000-0000-0000-0000-000000000000/allocations"
payload = { "splits": [ { "portfolio_id": "00000000-0000-0000-0000-000000000000", "qty": 0 } ] }headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())use serde_json::json;use reqwest;
#[tokio::main]pub async fn main() { let url = "http://localhost:3001/orders/00000000-0000-0000-0000-000000000000/allocations";
let payload = json!({"splits": ( json!({ "portfolio_id": "00000000-0000-0000-0000-000000000000", "qty": 0 }) )});
let mut headers = reqwest::header::HeaderMap::new(); headers.insert("Authorization", "Bearer <token>".parse().unwrap()); headers.insert("Content-Type", "application/json".parse().unwrap());
let client = reqwest::Client::new(); let response = client.post(url) .headers(headers) .json(&payload) .send() .await;
let results = response.unwrap() .json::<serde_json::Value>() .await .unwrap();
dbg!(results);}Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string format: uuid
Block order ID
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
splits
required
Array<object>
object
portfolio_id
required
string format: uuid
qty
required
number format: double
Example generated
{ "splits": [ { "portfolio_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "qty": 1 } ]}Responses
Section titled “Responses”Allocated
Media typeapplication/json
Array<object>
object
created_at
required
string format: date-time
from_portfolio_id
required
string format: uuid
id
required
string format: uuid
instrument_id
required
string
order_id
required
string format: uuid
price
required
number format: double
qty
required
number format: double
to_portfolio_id
required
string format: uuid
Example generated
[ { "created_at": "2026-04-15T12:00:00Z", "from_portfolio_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "instrument_id": "example", "order_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "price": 1, "qty": 1, "to_portfolio_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }]No allocate grant on the block portfolio
Order not found
Nothing filled, over-allocation, or invalid target