# True Markets Gateway API

Gateway API for the True Markets trading platform - order orchestration, quotes, and balance management

Version: 1.0.0

## Servers

Production
```
https://api.truemarkets.co/v1/conductor
```

## Security

### bearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[True Markets Gateway API](https://docs.truemarkets.co/_spec/APIs/Gateway/v1.yaml)

## Quotes

Request real-time market quotes for trading pairs without creating an order.

### Compute market quote

 - [POST /quotes](https://docs.truemarkets.co/apis/gateway/v1/quotes/computequote.md): Returns a quote for a market order without creating an order

## Orders

Create, execute, cancel, and monitor orders across CeFi and DeFi.

### Create new order

 - [POST /orders](https://docs.truemarkets.co/apis/gateway/v1/orders/createorder.md): Creates a new order. For DeFi orders, returns unsigned payloads for client signing.

### List user orders

 - [GET /orders](https://docs.truemarkets.co/apis/gateway/v1/orders/listorders.md): Returns a paginated list of completed and failed orders with execution data for the authenticated user

### Execute pending order

 - [POST /orders/{id}/execute](https://docs.truemarkets.co/apis/gateway/v1/orders/executeorder.md): Executes a pending order using client-provided signatures for the unsigned payloads

### Cancel a pending limit order

 - [DELETE /orders/{id}](https://docs.truemarkets.co/apis/gateway/v1/orders/cancelorder.md): Submits a cancellation request for a pending limit order on CeFi.

Cancellation is asynchronous — the order moves to  immediately,
then the order syncer reconciles the final state:
-  if the CeFi exchange confirms the cancellation
-  if the order filled before the cancel landed (race condition)

Only CeFi limit orders in  or  status are cancellable.
DeFi orders and market orders return 400.


### Get order status

 - [GET /orders/{id}/status](https://docs.truemarkets.co/apis/gateway/v1/orders/getorderstatus.md): Returns the current status of an order

## Balances

Query account balances for the authenticated user.

### Get user balances

 - [GET /balances](https://docs.truemarkets.co/apis/gateway/v1/balances/getbalances.md): Returns balances for the authenticated user

## Other

### List balances

 - [GET /balances/unified](https://docs.truemarkets.co/apis/gateway/v1/other/listbalances.md): Returns unified balances across CeFi and DeFi for the authenticated user