---
title: "Register heartbeat"
method: POST
path: "/heartbeat"
tags: ["Heartbeat"]
---

# Register heartbeat

`POST /heartbeat`

To register and refresh your heartbeat with 0 > `timeoutSeconds` <= 3600. Ping this endpoint to maintain your heartbeat after initial registration.

## Request body

- object
  - `requestor` string, required — The ethereum address associated with your account
  - `timeoutSeconds` integer, required — The number of seconds before heartbeat service times out and cancels your open orders

## Response `201`

- object
  - `status` string — `success` or `failure` if the request succeeded or not
  - `data` object
    - `requestor` string — The ethereum address associated with your account
    - `timeoutSeconds` integer — The number of seconds before heartbeat service times out and cancels your open orders
    - `expiresAt` string, date-time — A JS Date object describing when the heartbeat will timeout/expire (UTC)

## Other responses

- `400` — Bad request — missing or invalid `requestor` or `timeoutSeconds`

---

[API](https://skmtc.net/sx/apis/sx-bet-api.md) · [All operations](https://skmtc.net/sx/apis/sx-bet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sx/sx-bet-api/versions/eb2c05c3a98e/schema)