private/get_access_log

Retrieves a log of API access attempts and authentication events for the authenticated account. The log includes information such as IP addresses, timestamps, API methods called, and authentication status.

Use this method to monitor account security, review API usage patterns, and identify unauthorized access attempts. Results can be paginated using the offset and count parameters.

Scope: account:read

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_access_log \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "private/get_access_log",
  "params": {
    "offset": 0,
    "count": 3
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "records_total": 34,
    "data": [
      {
        "timestamp": 1575876682576,
        "result": "success",
        "ip": "127.0.0.1",
        "id": 45,
        "country": "Local Country",
        "city": "Local Town"
      },
      {
        "timestamp": 1575876459309,
        "result": "success",
        "ip": "127.0.0.1",
        "id": 44,
        "country": "Local Country",
        "city": "Local Town"
      },
      {
        "timestamp": 1575546252774,
        "result": "disabled_tfa",
        "ip": "127.0.0.1",
        "id": 43,
        "country": "Local Country",
        "city": "Local Town"
      }
    ]
  },
  "usIn": 1575903572350348,
  "usOut": 1575903572351765,
  "usDiff": 1417,
  "testnet": false
}

Query Parameters

offset · integer

The offset for pagination, default - 0

Example:

10

count · integer

Number of requested items, default - 10, maximum - 1000

Required range: 1 <= x <= 1000

Response

200 - application/json

Success response

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object[] · required

Hide child attributes

result. id · integer · required

Unique identifier

Example:

5967413

result. ip · string · required

IP address of source that generated action

result. timestamp · integer · required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result. country · string · required

Country where the IP address is registered (estimated)

result. city · string · required

City where the IP address is registered (estimated)

result. log · string · required

Action description. Possible values:

• changed_email - email was changed
• changed_password - password was changed
• disabled_tfa - TFA was disabled
• enabled_tfa - TFA was enabled
• success - successful login
• failure - login failure
• enabled_subaccount_login - login was enabled for subaccount (in data - subaccount uid)
• disabled_subaccount_login - login was disabled for subaccount (in data - subaccount uid)
• new_api_key - API key was created (in data key client id)
• removed_api_key - API key was removed (in data key client id)
• changed_scope - scope of API key was changed (in data key client id)
• changed_whitelist - whitelist of API key was edited (in data key client id)
• disabled_api_key - API key was disabled (in data key client id)
• enabled_api_key - API key was enabled (in data key client id)
• reset_api_key - API key was reset (in data key client id)

result. data · object string

Optional, additional information about action, type depends on log value

id · integer

The id that was sent in the request