List account events

GET/v3-node-0/smartaccount/{account}/events

List account eventsSmart accounts

Returns protocol events filtered by smart account address with pagination

Base URL https://api.storm.tg

Parameters

Path

accountstringrequired

Smart account address

Example: string

Query

orderstringoptional

Sort order (ASC or DESC, default: DESC)

Example: string

limitintegeroptional

Maximum number of events to return (default: 100, max: 1000)

Example: 0

offsetintegeroptional

Number of events to skip (default: 0)

Example: 0

event_typestringoptional

Filter by event type. Supports comma-separated list. Case-insensitive. Examples: DEPOSIT_NOTIFY or deposit_notify,withdraw,excess. Available types: trade_notification_v2, referral_fees, bundle_external_body, notify_update_position, add_gas_units, withdraw, add_public_key, remove_public_key, remove_all_except_current_public_key, deposit_notify, deposit_notify_with_deploy, excess, take_position_v2, failed_bundle_execution, withdraw_request

Example: string

Examples

curl --request GET 'https://api.storm.tg/v3-node-0/smartaccount/{account}/events' \
  --header 'Accept: application/json'

const response = await fetch("https://api.storm.tg/v3-node-0/smartaccount/{account}/events", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  },
});
console.log(response.status, await response.text());

import requests
 
response = requests.request(
    "GET",
    "https://api.storm.tg/v3-node-0/smartaccount/{account}/events",
    headers={"Accept":"application/json"},
    timeout=30,
)
print(response.status_code, response.text)

Responses

200OKapplication/json

Array of Trading.proto.ProtocolEvents

accountstringoptional

Example: string

eventanyoptional

Types that are valid to be assigned to Event:

*ProtocolEvents_TradeNotificationV2
*ProtocolEvents_ReferralFees
*ProtocolEvents_BundleExternalBody
*ProtocolEvents_NotifyUpdatePosition
*ProtocolEvents_AddGasUnits
*ProtocolEvents_Withdraw
*ProtocolEvents_AddPublicKey
*ProtocolEvents_RemovePublicKey
*ProtocolEvents_RemoveAllExceptCurrentPublicKey
*ProtocolEvents_DepositNotify
*ProtocolEvents_DepositNotifyWithDeploy
*ProtocolEvents_Excess
*ProtocolEvents_TakePositionV2
*ProtocolEvents_FailedBundleExecution
*ProtocolEvents_WithdrawRequest
*ProtocolEvents_InitSa

hashinteger[]optional

Array items · integer

integer

View example

[
  0
]

senderobjectoptional

Trading.proto.Address · 1 field

valuestringoptional

Example: string

View example

{
  "value": "string"
}

sequenceintegeroptional

Example: 0

timestampintegeroptional

Example: 0

tx_statusobjectoptional

Trading.proto.TransactionStatus · 3 fields

action_result_codeintegeroptional

Example: 0

exit_codeintegeroptional

Example: 0

successbooleanoptional

Example: true

View example

{
  "action_result_code": 0,
  "exit_code": 0,
  "success": true
}

[
  {
    "account": "string",
    "hash": [
      0
    ],
    "sender": {
      "value": "string"
    },
    "sequence": 0,
    "timestamp": 0,
    "tx_status": {
      "action_result_code": 0,
      "exit_code": 0,
      "success": true
    }
  }
]