跳到主要内容

更新交易对参数

描述​

更新已有现货交易对的交易参数（费率、最小价格变动、最小数量、最小名义价值）。未传入的字段保持不变——仅更新请求体中出现的字段。

仅管理员。 服务器须设置 ADMIN_API_KEY 环境变量，且请求头中须传入 X-API-Key。

关于现有挂单的说明： 本次调用后，已有的挂单不会根据新的 tick_size 或 lot_size 重新校验。这些挂单将保留在订单簿上，直到成交或撤销。更新后新下的订单必须满足新参数要求。

HTTP 请求​

PATCH /admin/spot/markets/:id (X-API-Key: ADMIN_API_KEY)

:id 为交易对标识符（如 DFUSDT）。区分大小写。

权重​

0 — 管理员接口不设权重限制。每次市场变更都会向撮合引擎发送 ReloadMarket 命令，使内存中的 MarketCache 无需重启即可获取最新配置。

请求参数​

名称类型必填描述
tick_sizeDECIMAL可选新的最小价格变动单位，以字符串表示（如 "0.0001"）。不传则保持不变。
lot_sizeDECIMAL可选新的最小数量变动单位，以字符串表示（如 "0.01"）。不传则保持不变。
min_notionalDECIMAL可选新的最小名义价值，以字符串表示（如 "1"）。不传则保持不变。
maker_fee_bpsNUMBER可选新的 Maker 费率，以基点表示（整数）。不传则保持不变。
taker_fee_bpsNUMBER可选新的 Taker 费率，以基点表示（整数）。不传则保持不变。

至少应传入一个字段；发送空请求体为空操作（请求成功，但无参数变更）。

响应示例​

200 OK

{
  "ok": true,
  "id": "DFUSDT"
}
字段说明
ok成功时始终为 true。
id已更新的交易对标识符，原样返回。

错误响应​

HTTPerror触发条件
500DB_ERROR更新时发生意外的 Postgres 错误。请查看服务器日志。

完整列表：错误代码。

代码示例​

cURL​

ADMIN_API_KEY="your_admin_api_key"
MARKET_ID="DFUSDT"

curl -s -X PATCH "https://api-sepolia.p99.world/api/v1/admin/spot/markets/${MARKET_ID}" \
  -H "X-API-Key: ${ADMIN_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "tick_size":     "0.0001",
    "maker_fee_bps": 5,
    "taker_fee_bps": 10
  }'

Python​

import requests

ADMIN_API_KEY = "your_admin_api_key"
BASE_URL      = "https://api-sepolia.p99.world/api/v1"

def admin_patch(path: str, body: dict) -> dict:
    r = requests.patch(
        f"{BASE_URL}{path}",
        json=body,
        headers={"X-API-Key": ADMIN_API_KEY, "Content-Type": "application/json"},
        timeout=5,
    )
    r.raise_for_status()
    return r.json()

result = admin_patch("/admin/spot/markets/DFUSDT", {
    "tick_size":     "0.0001",
    "maker_fee_bps": 5,
    "taker_fee_bps": 10,
})
print(result["ok"], result["id"])