API Idempotency

The Fireblocks API supports idempotent requests (multiple requests which have the same result as making a single request). This is helpful when you don’t get a response or the API call isn’t completed successfully.

Idempotency key


Note: You can only use idempotency keys with POST requests. Using Idempotency-Key in your request header for GET and DELETE will not work as they are inherently idempotent.

In order to submit an idempotent request, you would need to specify an idempotency key. To make an idempotent request, add Idempotency-Key: <key> to the header of your POST request.

Resubmission of the same request with the same idempotency key will not trigger the same operation, but will instead return the original response. This ensures a transaction request with the same idempotency key is not executed multiple times if you try to re-submit it (for example, due to network errors or delays experienced for a prior submission).

Fireblocks stores the responses for all requests with the Idempotency-Key header and re-sends them for every request with the same idempotency key for 24 hours. After 24 hours, you will need a new key.