Check Trade Status API
The Check Trade Status API allows you to monitor the execution status of your orders in real-time. Use this endpoint to check if an order has been filled, partially filled, cancelled, or is still pending.
Endpoint
GET /trade/{portfolioId}/status/{requestId}Authentication
All requests require the IdToken obtained from the authentication flow:
Authorization: Bearer <ID_TOKEN>
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| portfolioId | string | Yes | The portfolio ID where the order was placed (e.g., "default") |
| requestId | string | Yes | The order ID (requestId) returned from the Place Trade API response |
Request Format
Request Body: No request body is required for this endpoint.
Response Format
| Field | Type | Description |
|---|---|---|
| avgPrice | number | Average price per share at which the order was executed (null if not yet filled) |
| status | string | Current order status - see status values below |
| updatedDate | number | Unix timestamp (milliseconds) of the last status update |
Order Status Values:
| Status | Description |
|---|---|
| CREATED | Order has been created but not yet sent to the market |
| PENDING | Order is waiting for execution |
| SUCCESS | Order has been successfully executed and filled |
| CANCELLED | Order has been cancelled and will not execute |
| FAILED | Order failed to execute due to an error or market condition |
| PENDING_CANCEL | Order cancellation is in progress |
| SCHEDULED | Order is scheduled for future execution |
| IN_PROGRESS | Order is currently being executed |