Skip to main content
POST
/
v1
/
heartbeats
Post a heartbeat
curl --request POST \
  --url https://clob.kuest.com/v1/heartbeats \
  --header 'Content-Type: application/json' \
  --header 'KUEST_ADDRESS: <kuest_address>' \
  --header 'KUEST_API_KEY: <kuest_api_key>' \
  --header 'KUEST_PASSPHRASE: <kuest_passphrase>' \
  --header 'KUEST_SIGNATURE: <kuest_signature>' \
  --header 'KUEST_TIMESTAMP: <kuest_timestamp>' \
  --data '
{
  "heartbeat_id": "<string>"
}
'
{
  "heartbeat_id": "<string>"
}
Send a heartbeat to keep orders active.
This endpoint requires L2 authentication headers: KUEST_ADDRESS, KUEST_SIGNATURE, KUEST_TIMESTAMP, KUEST_API_KEY, and KUEST_PASSPHRASE.
Use the returned heartbeat_id in subsequent requests to continue the session.

Headers

​
KUEST_ADDRESS
string
required

Checksummed wallet address performing the request.

​
KUEST_API_KEY
string<uuid>
required

API key obtained from the L1 derivation endpoint.

​
KUEST_PASSPHRASE
string
required

64 character hexadecimal passphrase associated with the API key.

​
KUEST_TIMESTAMP
string
required

Millisecond epoch timestamp (string) used for freshness checks.

​
KUEST_SIGNATURE
string
required

Hex-encoded HMAC-SHA256 signature built from the L2 signing string.

Body

application/json
​
heartbeat_id
string | null

Heartbeat identifier to continue an existing session.

Response

Heartbeat accepted.

​
heartbeat_id
string
required

Current heartbeat identifier.