Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hit.com/llms.txt

Use this file to discover all available pages before exploring further.

Private trading endpoints use API key HMAC authentication. Public market data endpoints do not require credentials. For implementation examples in TypeScript, Python, and Rust, see Developer Authentication.

REST Headers

Include these headers on private REST requests:
HeaderTypeRequiredDescription
hit-api-keystringYesAPI key identifier.
hit-signaturestringYesHMAC-SHA256 signature.
hit-timestampstringYesUnix timestamp in milliseconds.
hit-passphrasestringYesAPI passphrase.
Signature message:
timestamp + method + path + body
Rules:
RuleDescription
methodUppercase HTTP method, such as GET, POST, or DELETE.
pathFull API path including /api/v1, excluding scheme, host, and query string.
bodyExact JSON body string sent on the request, or an empty string for no body.
timestamp windowRequests must be within 30 seconds of server time.

WebSocket Auth Payload

Authenticate the /user namespace by emitting user-connect after connecting. Payload type: TradingApiKeyAuth.
FieldTypeRequiredDescription
apiKeystringYesAPI key identifier.
signaturestringYesHMAC-SHA256 signature.
timestampstringYesUnix timestamp in milliseconds.
passphrasestringYesAPI passphrase.
Signature message:
timestamp + WEBSOCKET + /user
Authentication result event: user-authenticated.
FieldTypeRequiredDescription
successbooleanYesWhether authentication succeeded.
errorstringNoFailure reason.