Skip to main content
POST
/
v1
/
mm
/
heartbeat
curl -X POST https://api.totalis.trade/v1/mm/heartbeat \
  -H "X-API-Key: $API_KEY"

{
  "data": {
    "status": "ok",
    "mm_id": "mm-uuid-1234",
    "ttl_ms": 60000
  }
}
Send a liveness heartbeat to the Quote Service. The server tracks heartbeats to monitor market maker availability. Send a heartbeat at least every 30 seconds to stay within the 60-second TTL.

​
Authentication

API key required. Pass your market maker API key in the X-API-Key header. 
X-API-Key: <key>

​
Request Body

No request body required.

​
Response

​
data
object
Send a heartbeat every 30 seconds to stay well within the 60-second TTL. Run this alongside your SSE stream connection.

​
Errors

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid API key.
curl -X POST https://api.totalis.trade/v1/mm/heartbeat \
  -H "X-API-Key: $API_KEY"

{
  "data": {
    "status": "ok",
    "mm_id": "mm-uuid-1234",
    "ttl_ms": 60000
  }
}