---
title: "Set market warning"
method: POST
path: "/admin/market-warning"
tags: ["Admin"]
---

# Set market warning

`POST /admin/market-warning`

## Request

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

Schedule a custom warning for one market. Clients display it from starts_at until ends_at. Pass clear=true to remove it.

## Request body

- ApiSetMarketWarningRequest
  - `market_id` string, int64: Market whose trading page should show the warning.
  - `message` string: Custom warning text (maximum 1000 characters).
  - `starts_at` string, int64: Start of the display window as Unix seconds.
  - `ends_at` string, int64: End of the display window as Unix seconds; must be later than starts_at.
  - `clear` boolean: Remove the configured warning. Other fields are ignored when true.

## Response `200`

A successful response.

- ApiSetMarketWarningResponse
  - `market_id` string, int64
  - `message` string
  - `starts_at` string, int64
  - `ends_at` string, int64
  - `cleared` boolean: True when the warning was cleared.

## 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/market-warning/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)