Pause Dealer

Pause a dealer to stop quoting.

Endpoint

POST /api/v3/fermata/dealer/pause

Description

Pauses a dealer. A paused dealer rejects new quote requests but continues hedging open positions. Admin only.

Authentication

Requires Bearer token authentication with admin role.

Authorization: Bearer {access_token}

Request Body

Field	Type	Required	Description
dealerAccountId	string	Yes	Dealer account ID to pause

Response

Returns the updated dealer object with status: "PAUSED".

Usage

import requests

headers = {"Authorization": f"Bearer {access_token}"}

response = requests.post(
    "https://cadenza-api.algo724.com/api/v3/fermata/dealer/pause",
    headers=headers,
    json={"dealerAccountId": "550e8400-e29b-41d4-a716-446655440000"}
)

dealer = response.json()["data"]
print(f"Dealer {dealer['name']} is now {dealer['status']}")

curl -X POST https://cadenza-api.algo724.com/api/v3/fermata/dealer/pause \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"dealerAccountId": "550e8400-e29b-41d4-a716-446655440000"}'

Example Response

{
  "data": {
    "dealerAccountId": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Main Dealer",
    "status": "PAUSED",
    "baseCurrencies": ["USDT", "USDC"],
    "riskThreshold": "1000000",
    "linkedAccountIds": [],
    "config": {},
    "createdAt": 1711929600000,
    "createdAtDateTime": "2025-04-01T00:00:00.000Z",
    "updatedAt": 1711930200000,
    "updatedAtDateTime": "2025-04-01T00:10:00.000Z"
  },
  "success": true,
  "errno": 0,
  "error": null
}

Error Responses

HTTP Code	Error	Description
400	Invalid request	Dealer is already paused or archived
401	Unauthorized	Invalid or expired access token
403	Forbidden	Requires admin role
404	Not found	Dealer not found

Example Error

{
  "data": null,
  "success": false,
  "errno": -130004,
  "error": "Dealer is already paused"
}

Notes

• Only ACTIVE dealers can be paused
• Hedging of open positions continues while paused
• Use fermata.dealer.resume to resume quoting