session-management

HMAC Login

Login and generate a new session associated with a JWT using HMAC. Once you log in from an IP, the same IP must be used for the duration of the session for any subsequent requests.

Ratelimited: True

get/v1/users/hmac/login

Request

Base URL
https://api.exchange.bullish.com/trading-api
Auth
none required
TypeScript
https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v1/users/hmac/login/get.ts
A function with typed inputs. Its response is checked against the schema.

Headers

BX-SIGNATUREstring required

signature obtained using the signing format

BX-TIMESTAMPstring required

timestamp is the number of milliseconds since EPOCH

BX-NONCEstring required

nonce is a client side incremented unsigned 64 bit integer

BX-PUBLIC-KEYstring required

public key being used to generate the JWT

Response

returns JWT and the authorizer for signing requests

authorizerstring string required

JWT authorizer you obtain along with the JWT token

tokenstring string required

JWT token

Example response

{
  "authorizer": "03E02367E8C900000500000000000000",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoic2FuZGVlcCByYWtocmEifQ.wyVq6PlKaldWXtu-jz2hJCvkGl1lM2S7HUKCH8LnXp0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.