Skip to main content
POST
/
v1
/
orders
curl -X POST https://api.galadriel.com/v1/orders \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "side": "buy",
    "gpu_type": "h100",
    "gpu_count": 16,
    "zone": "us-west-1",
    "duration_hours": 24,
    "order_type": "limit",
    "limit_price": 1.30
  }'

{
  "order_id": "ord_abc123",
  "side": "buy",
  "gpu_type": "h100",
  "gpu_count": 16,
  "zone": "us-west-1",
  "duration_hours": 24,
  "order_type": "market",
  "status": "filled",
  "matched_price": 1.40,
  "total_cost": 537.60,
  "lease_id": "lse_xyz123",
  "created_at": "2025-11-11T14:00:00Z",
  "filled_at": "2025-11-11T14:00:01Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.galadriel.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Request Body

​
side
string
required
Order side: buy or sell
​
gpu_type
string
required
GPU type: h100, h200, b200, or b300
​
gpu_count
integer
required
Number of GPUs (must be multiple of 8)
​
zone
string
required
Availability zone: us-west-1, us-east-1, or eu-west-1
​
duration_hours
integer
required
Lease duration in hours (1-720)
​
order_type
string
default:"market"
Order type: market or limit
​
limit_price
number
Price per GPU/hour (required for limit orders)
​
start_time
string
Start time in ISO 8601 format (default: now)
​
flexible_window_hours
integer
Flexible execution window in hours (enables flexible pricing)

​
Response

​
order_id
string
Unique order identifier
​
status
string
Order status: pending, partial, filled, or cancelled
​
matched_price
number
Actual matched price per GPU/hour
​
lease_id
string
Lease ID (if order filled immediately)
curl -X POST https://api.galadriel.com/v1/orders \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "side": "buy",
    "gpu_type": "h100",
    "gpu_count": 16,
    "zone": "us-west-1",
    "duration_hours": 24,
    "order_type": "limit",
    "limit_price": 1.30
  }'

{
  "order_id": "ord_abc123",
  "side": "buy",
  "gpu_type": "h100",
  "gpu_count": 16,
  "zone": "us-west-1",
  "duration_hours": 24,
  "order_type": "market",
  "status": "filled",
  "matched_price": 1.40,
  "total_cost": 537.60,
  "lease_id": "lse_xyz123",
  "created_at": "2025-11-11T14:00:00Z",
  "filled_at": "2025-11-11T14:00:01Z"
}