Get an order
curl --request GET \
--url https://api.paperdrill.dev/v1/orders/{orderId} \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.paperdrill.dev/v1/orders/{orderId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.paperdrill.dev/v1/orders/{orderId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "order_123",
"userId": "user_123",
"symbol": "SOL_USD",
"side": "BUY",
"type": "LIMIT",
"status": "PARTIALLY_FILLED",
"price": "125.50",
"qty": "2.00",
"filledQty": "0.50",
"averagePrice": "125.25",
"createdAt": "2026-09-19T10:00:00.000Z"
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": [
{
"field": "qty",
"message": "invalid decimal format"
}
]
},
"requestId": "f4c0baf4-b8d2-4c9a-a17b-c8656c4a7b0e"
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": [
{
"field": "qty",
"message": "invalid decimal format"
}
]
},
"requestId": "f4c0baf4-b8d2-4c9a-a17b-c8656c4a7b0e"
}Orders
Get an order
Returns one order owned by the caller.
Requires the ORDER_READ scope.
GET
/
orders
/
{orderId}
Get an order
curl --request GET \
--url https://api.paperdrill.dev/v1/orders/{orderId} \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.paperdrill.dev/v1/orders/{orderId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.paperdrill.dev/v1/orders/{orderId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "order_123",
"userId": "user_123",
"symbol": "SOL_USD",
"side": "BUY",
"type": "LIMIT",
"status": "PARTIALLY_FILLED",
"price": "125.50",
"qty": "2.00",
"filledQty": "0.50",
"averagePrice": "125.25",
"createdAt": "2026-09-19T10:00:00.000Z"
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": [
{
"field": "qty",
"message": "invalid decimal format"
}
]
},
"requestId": "f4c0baf4-b8d2-4c9a-a17b-c8656c4a7b0e"
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": [
{
"field": "qty",
"message": "invalid decimal format"
}
]
},
"requestId": "f4c0baf4-b8d2-4c9a-a17b-c8656c4a7b0e"
}Authorizations
A scoped API key created in the PaperDrill dashboard.
Path Parameters
Order identifier.
Response
Order returned successfully.
Available options:
BUY, SELL Available options:
LIMIT, MARKET Available options:
OPEN, PARTIALLY_FILLED, FILLED, CANCELLED A non-negative decimal encoded as a string.
Pattern:
^\d+(\.\d+)?$Example:
"125.50"
A non-negative decimal encoded as a string.
Pattern:
^\d+(\.\d+)?$Example:
"125.50"
Present for limit orders.
Pattern:
^\d+(\.\d+)?$Example:
"125.50"
Present after at least one fill.
Pattern:
^\d+(\.\d+)?$Example:
"125.50"