Get Hyperliquid USDC flow events

Authorizations

X-API-Key

string

header

required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Headers

0xArchive-Version

enum<string>

Selects the 2026-10 response contract. Send 2026-10-01; any dated version on or after it selects the same shapes. Without the header every response keeps its existing shape. With it:

The data quality routes, /v1/status/coverage and /v1/symbols answer the standard {success, data, meta} envelope.
Record times that are integer milliseconds by default become RFC 3339 UTC strings with millisecond precision, and the integer moves to a *_ms field: L4 resting-order timestamp (timestamp_ms), CVD buckets, HIP-3 oracle reads, Lighter and Lighter on Robinhood Chain liquidations and liquidation volume. Levels and trigger-levels snapshot_ts become RFC 3339 with snapshot_ts_ms.
Error bodies carry the contract error_code names: invalid_parameter instead of invalid_query_params and invalid_path_params, historical_depth_exceeded instead of history_window_exceeded, and historical_range_exceeded instead of request_range_exceeded; a malformed cursor that fails to parse answers 400 invalid_cursor instead of invalid_query_params. With 0xArchive-Version: 2026-10-01, malformed cursors on trades, liquidations, L2 and L4 diffs, order history, TP/SL and order-flow routes answer 400 invalid_cursor. Without the header, the first six route families treat a malformed cursor as no cursor and return the first page; order flow answers 400 invalid_query_params. Malformed trade time inputs answer 400 invalid_time_range with the header and 400 invalid_query_params without it.

The response echoes the selected version in its own 0xArchive-Version header.

Available options:

2026-10-01

Example:

"2026-10-01"

Query Parameters

start

Start of the window, inclusive. Defaults to 24 hours before end, so set it explicitly when paging: the default moves with the clock. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z. An instant: Unix milliseconds, or an RFC 3339 string such as 2026-01-01T00:00:00Z (encode a + offset as %2B). An unparsable value answers 400 invalid_time_range.

Example:

1767225600000

end

End of the window, inclusive. Defaults to now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z. An instant: Unix milliseconds, or an RFC 3339 string such as 2026-01-01T00:00:00Z (encode a + offset as %2B). An unparsable value answers 400 invalid_time_range.

Example:

1767225600000

cursor

string

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page.

limit

integer

default:100

Events per page (default: 100, max: 1,000). A larger value is read as 1,000.

Required range: x <= 1000

min_usd

number

default:0

Only events of at least this many USD (default: 0, max: 1000000000000).

Required range: 0 <= x <= 1000000000000

kind

enum<string>

Only events of this kind (default: every kind).

Available options:

deposit,

withdraw,

evm_in,

evm_out

Response

USDC flow events

API response containing USDC flow events.

success

boolean

Example:

true

data

object[]

Hide child attributes

data.id

string

required

The event's identity, block_number:event_index. Deduplicate and join pages on it: (timestamp, tx_hash) is not unique, because a bridge batch finalizes up to 10 withdrawals under one hash and one millisecond.

Example:

"1194932733:0"

data.timestamp

string<date-time>

required

Execution time, RFC 3339 UTC with milliseconds.

Example:

"2026-10-24T00:35:30.560Z"

data.timestamp_ms

integer<int64>

required

timestamp as Unix milliseconds.

Example:

1792802130560

data.kind

enum<string>

required

deposit and withdraw: the Arbitrum bridge. evm_in and evm_out: USDC from and to HyperEVM, which is also how CCTP moves USDC in and out of HyperCore.

Available options:

deposit,

withdraw,

evm_in,

evm_out

Example:

"evm_out"

data.amount_usd

number<double>

required

USDC moved, zero or more; kind gives the direction.

Example:

7000000

data.fee_usd

number<double>

required

The withdrawal fee (1 USDC) or a transfer's fee charged in USDC, else 0.

Example:

0

data.user

string | null

required

The HyperCore account the USDC entered or left.

Example:

"0x7fdafde5cfb5465924316eced2d3715494c517d1"

data.tx_hash

string | null

required

The HyperCore transaction hash.

Example:

"0x429c669731c25129441604473939fd0202a3007cccc56ffbe66511e9f0c62b13"

data.block_number

integer<int64>

required

HyperCore block number.

Example:

1194932733

data.event_index

integer

required

Position of the event within its block.

Example:

0

Endpoint reference

Requests and responses

Datasets

Venues

OpenAPI and schemas

Guides

Get Hyperliquid USDC flow events

Authorizations

Headers

Query Parameters

Response