Skip to main content

Authentication

The PipAI API uses API keys plus request signing. Each request must include the API key and an HMAC signature computed over the request body and timestamp.

API keys

Generate keys from the PipAI dashboard. Each key has a set of permissions (read-only, trade, withdraw) that determine which endpoints it can call.

Signing

  1. Build the canonical string: timestamp + method + path + body.
  2. Compute HMAC-SHA256(secret, canonical).
  3. Send the result hex-encoded in the X-PipAI-Signature header.

Required headers

HeaderDescription
X-PipAI-API-KeyYour API key
X-PipAI-TimestampRequest timestamp in milliseconds
X-PipAI-SignatureHex-encoded HMAC-SHA256

Key rotation

Keys can be rotated from the dashboard without downtime. Old and new keys are both valid for a configurable grace window.