Idempotency

Operations that create staking resources, requests, or transactions require an Idempotency-Key header. Use a unique, non-empty value of at most 255 characters for each logical operation.

curl --request POST "https://api.staking.0xmakase.co.jp/v1/ethereum/stakes" \
  --header "Authorization: Bearer ${OMAKASE_API_KEY}" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
  --data '{
    "network": "mainnet",
    "amountEth": 32,
    "withdrawalAddress": "0x000000000000000000000000000000000000dEaD"
  }'

Retry the same logical operation with the same key and the same request. Reusing a key with a different request returns 409 Conflict.

Generate keys in your application and persist each key with the operation it identifies. Do not derive a key only from the current timestamp if concurrent callers could produce the same value.