Credentials
A key pair signs every request in both directions.
| Value | Format | Where it comes from |
|---|---|---|
| key_id | ak_ + 24 hex characters. Travels in the clear. | Issued by your account manager together with the secret |
| secret | 32+ characters | Handed over once, out of band. Stored encrypted, never read back |
| wallet_url | HTTPS URL | Yours. One URL; the action is in the body |
Rotation
A rotated key gets a new pair. The two directions change at different times:
- Your calls to us are accepted with the old key for 48 hours: switch your servers to the new one whenever it suits you inside that window.
- Our calls to your wallet are signed with the new key within a minute of the rotation. Put the new secret into your wallet before you rotate, or within that minute, and verify against both keys you hold — otherwise your wallet answers
INVALID_SIGNATUREto every bet until it has the new secret.
Each call names its key in X-Agg-Key-Id, so a wallet that keeps both secrets picks the right one.
Revoke stops a key at once. It is for a secret that has leaked, not for an orderly change.
