Refresh Token

This endpoint creates a new access token using a refresh token.

Request Headers:

• Content-Type: application/x-www-form-urlencoded

Important Notes:

• Refresh token duration is 600 seconds
• Rate limit: 1 request per second
• The IP of the client must be added to WB Allowlist

POST /oauth2/refresh_token

Refresh Token

cURL

curl --request POST \
  --url https://whitebit.com/oauth2/refresh_token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data client_id=YOUR_CLIENT_ID \
  --data client_secret=YOUR_CLIENT_SECRET \
  --data token=REFRESH_TOKEN

200

{
  "data": {
    "access_token": "NTBLZJKYNZETNJFIZC0ZNGM1LWJMYTMTODBJYZRKNWE2NMRM",
    "expires_in": 300,
    "refresh_token": "ODZMNMRHM2ETMZQZZI01OTQYLWEWMZATNWQ0NDYZNJBMOWUW",
    "scope": "codes.apply,show.userinfo",
    "token_type": "Bearer"
  }
}

Body

application/x-www-form-urlencoded

client_id · string · required

The application's client ID

Example:

"YOUR_CLIENT_ID"

client_secret · string · required

The application's client secret

Example:

"YOUR_CLIENT_SECRET"

token · string · required

The refresh token received from the token endpoint

Example:

"REFRESH_TOKEN"

Response

200

application/json

Successful token refresh

data · object

Show child attributes