Skip to main content

Resume Dealer

Resume a paused dealer.

Endpoint

POST /api/v3/fermata/dealer/resume

Description

Resumes a paused dealer, restoring its ability to accept quote requests. Admin only.

Authentication

Requires Bearer token authentication with admin role.

Authorization: Bearer {access_token}

Request Body

FieldTypeRequiredDescription
dealerAccountIdstringYesDealer account ID to resume

Response

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

Usage

import requests

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

response = requests.post(
"https://cadenza-api.algo724.com/api/v3/fermata/dealer/resume",
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/resume \
-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": "ACTIVE",
"baseCurrencies": ["USDT", "USDC"],
"riskThreshold": "1000000",
"linkedAccountIds": [],
"config": {},
"createdAt": 1711929600000,
"createdAtDateTime": "2025-04-01T00:00:00.000Z",
"updatedAt": 1711930800000,
"updatedAtDateTime": "2025-04-01T00:20:00.000Z"
},
"success": true,
"errno": 0,
"error": null
}

Error Responses

HTTP CodeErrorDescription
400Invalid requestDealer is not paused
401UnauthorizedInvalid or expired access token
403ForbiddenRequires admin role
404Not foundDealer not found

Example Error

{
"data": null,
"success": false,
"errno": -130005,
"error": "Dealer is not paused"
}

Notes

  • Only PAUSED dealers can be resumed
  • The dealer must still have at least one linked exchange account to generate quotes