Skip to main content
GET
List activity

Authorizations

Authorization
string
header
required

Scoped API key from the Totalis app settings. Each key acts for one account, yours or a maker's, and holds only scopes that account can use. Each operation lists the scopes it requires.

Headers

Origin
string

Required for browser sessions; API keys do not require an Origin.

Query Parameters

limit
integer
default:50

Maximum items per page, 1 to 200, default 50. A page may hold fewer, even none, while has_more is true. Maximum items in one page. A page may hold fewer, even none, while has_more is true.

Required range: 1 <= x <= 200
cursor
string

Omit for the first page; then send the previous response's next_cursor unchanged. Opaque list cursor. Send a previous response's next_cursor back unchanged; never build or parse one.

Required string length: 1 - 2048
kind
enum<string>

Return only activities of this kind.

Available options:
DEPOSIT,
WITHDRAWAL,
INTERNAL_TRANSFER,
ACCEPT,
CASHOUT,
POSITION_TRANSFER,
SETTLEMENT,
CLAIM,
FILL,
ORDER,
CREDIT,
CONVERSION,
FUNDING,
FEE,
CORRECTION,
REFUND
status
enum<string>

Return only activities with this status. A status-filtered page is a display view, never a balance or P&L basis.

Available options:
PENDING,
UNKNOWN,
COMMITTED,
FAILED,
REVERTED,
CORRECTED
from
string<date-time>

Inclusive RFC3339 lower bound on occurred_at (recorded_at for workflow entries without one). Chain activity whose occurrence time is unknown is always included.

through
string<date-time>

Exclusive RFC3339 upper bound on occurred_at (recorded_at for workflow entries without one). Chain activity whose occurrence time is unknown is always included.

position_id
string

Return only activities that reference this position ID (lowercase bytes32 hex).

Pattern: ^0x[0-9a-f]{64}$
venue
enum<string>

Return only activities with evidence from this source: HYPEREVM (EVM logs), HYPERCORE (Hyperliquid ledger) or VENUE (Totalis workflows).

Available options:
HYPEREVM,
HYPERCORE,
VENUE

Response

Your activity, built from on-chain records and operations. A key reads its own account's: yours, or its maker's. One freshness status covers the read; amounts are atomic USDC strings or null. No shared caching.

context
object
required

Freshness of this read: the oldest source observation and one status for every amount in the response.

items
object[]
required

Activities on this page, ordered by sequence, then activity_id, descending.

next_cursor
string | null
required

Opaque cursor for the next page, bound to this response's snapshot; null on the last page. Send it back unchanged as cursor.

Required string length: 1 - 2048
has_more
boolean
required

True when another page exists; true exactly when next_cursor is non-null.