---
title: "Set post-only mode"
method: POST
path: "/admin/post-only-mode"
tags: ["Admin"]
---

# Set post-only mode

`POST /admin/post-only-mode`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/admin/post-only-mode`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/admin/post-only-mode/post.ts> (a function with typed inputs; its response is checked against the schema)

Enable or disable post-only mode. When market_id is 0 (or unset), toggles the venue-wide kill switch; when market_id > 0, toggles the per-market override only. Effective post-only = venue-wide OR per-market.

## Request body

- ApiSetPostOnlyModeRequest
  - `enabled` boolean
  - `market_id` string, int64: Optional market_id. When 0 or unset, toggles the venue-wide kill switch (rejects non-post-only on every market). When > 0, toggles the per-market override only — used to keep newly-listed markets in post-only until liquidity is sufficient. Effective post-only for a market = venue-wide OR per-market.

## Response `200`

A successful response.

- ApiSetPostOnlyModeResponse
  - `enabled` boolean
  - `market_id` string, int64: Echo of the market_id that was set (0 = venue-wide).

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/admin/post-only-mode/post.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)