Skip to main content
THE PROOF

Sign bytes, not objects

The canonical signing input is:
The prefix and body are UTF-8 bytes. For a GET with no body, <raw-body> is empty.

Example POST

Sign that exact byte sequence with:

Signing examples

The following examples use the same canonical request and show the common implementation languages.

Five-minute window

X-Timestamp is Unix time in seconds. Bullring accepts timestamps within five minutes of its clock, in either direction.

Common mistakes

  • Signing pretty JSON and sending compact JSON.
  • Reordering JSON keys after signing.
  • Including a query string in the canonical path when the request path differs.
  • Reusing an idempotency ID for a different body.
  • Sending the PEM key instead of the Base64 signature.