Authenticate users as a liquid user by briefly redirecting the browser to a specified url.


In the context of QEX, OAuth can only be used to authenticate a session generated by the QEX API. This session can then be used to query the QEX API and/or initialize a widget integration.


1. Create Session

A session can be created via API.

POST https://partners.liquid.com/api/v1/session
  "public_api_key": "pk_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

   "message":"Session created.",

2. Associate session to User

Once a session has been created it can be associated with a user by having them approve the OAuth request. This is done by opening a browser window to the URL below.


Note: when OAuth is completed the user will be presented with an instruction to close the web browser and manually return to your app.

This can alternatively redirect the user to a specified URL or deep link.

See swagger

3. Fetch user account balances

The authenticated session can now be used to query the user account balances. See Authorization.

GET https://partners.liquid.com/api/v1/session/${session_id}/accounts
Authorization: Bearer {jwt}

4. Initialize Widget

The session id/key can be passed into the widget. This will cause the widget to assume the session of the user authenticated earlier.

  "public_api_key": "pk_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "identity": {
    "user_session": {
      "session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "session_secret": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Last updated