> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pumpevm.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# REST endpoints

> REST API surface for the CLOB (coming Q4 2026).

<Note>
  The REST API for the CLOB is scheduled for **Q4 2026**. WebSocket access is live today — see the [WebSocket API](/developers/clob/websocket).
</Note>

## Get order book (public)

```text theme={null}
GET /v1/prediction/orderbook/{marketId}
```

| Parameter  | Type    | Description                    |
| ---------- | ------- | ------------------------------ |
| `marketId` | string  | Market address                 |
| `outcome`  | string  | `YES` or `NO`                  |
| `depth`    | integer | Number of levels (default: 10) |

**Response**

```json theme={null}
{
  "marketId": "0x...",
  "outcome": "YES",
  "bids": [["0.65", "1000"], ["0.64", "2000"]],
  "asks": [["0.67", "500"], ["0.68", "1500"]]
}
```

## Place order

```text theme={null}
POST /v1/prediction/order
```

**Body**

```json theme={null}
{
  "marketId": "0x...",
  "outcome": "YES",
  "side": "buy",
  "orderType": "limit",
  "price": "0.65",
  "size": "1000"
}
```

## Cancel order

```text theme={null}
DELETE /v1/prediction/order/{orderId}
```

## Get positions

```text theme={null}
GET /v1/prediction/positions
```

## Get trade history

```text theme={null}
GET /v1/prediction/trades
```

| Parameter  | Type    | Description                    |
| ---------- | ------- | ------------------------------ |
| `marketId` | string  | Filter by market               |
| `outcome`  | string  | Filter by outcome              |
| `limit`    | integer | Number of trades (default: 50) |