Addresses

List an address's transactions

Keyset-paginated list of transactions involving an address within a mandatory block window (from_block and to_block are both required). direction=from returns transactions sent by the address; direction=to returns transactions received by the address; direction=any (the default) merges both sent and received transactions ordered by (block_number, tx_index) descending, folding a self-transaction (from == to == address) into a single row. Opaque pagination token from the previous response's next_cursor; pass it back unchanged.

Window and head clamping: to_block above as_of_block is 409 not_indexed_yet unless clamp=true, which truncates to_block down to as_of_block (never possible when from_block is itself already past it — that stays a hard 409 regardless of clamp). meta.finalized_block is a marker and never bounds a window. A window wider than 100,000 blocks is 409 window_too_large unless clamp=true, which truncates from the older end (raises from_block, keeps to_block fixed). The window's lower bound is computed per dataset, not from the chain's start alone: the address-transactions index is a derived dataset, and while its backfill is still filling older blocks its data starts above GET /chains coverage.from_block. The dataset's start only counts when it is higher than the start of the data it is derived from (a chain with no transaction at its beginning is not a gap). A window entirely before that start is 422 no_coverage; one that starts before it is partial, and clamp=true raises from_block to that start before the 100,000-block limit is applied. Limitation: during an ascending backfill the hole between the backfilled tail and the live start is not detected (the dataset's start is its lowest covered block), so a window inside that hole is still 200 with an empty list. When clamped or partial, meta.coverage = "partial" ("full" otherwise).

get/{chain}/addresses/{address}/transactions

Request

  • Base URL: https://api.blockvectra.com/v1/data
  • URL: https://api.blockvectra.com/v1/data/{chain}/addresses/{address}/transactions
  • Auth: API key in header x-api-key

Path parameters

chainstring required

Chain identifier: the chain value of an entry in GET /chains (for example robinhood_mainnet), which lists every value this API accepts, i.e. the exact lowercase form of that entry's chain_slug. Matching is exact and case-sensitive; other spellings, aliases and numeric chain IDs are not accepted and return 404 not_found (unknown or not-public chain). What the chain serves differs per chain: see that entry's features and coverage.

addressstring required

20-byte address. 0x/0X prefix optional; either hex digit case is accepted.

Example:0xAbCdEf0123456789aBcDeF0123456789aBCDEF01

20-byte address, 0x optional, either case.

Query parameters

from_blockinteger required

Window lower bound (inclusive), non-negative integer. Required — there is no unwindowed query.

to_blockinteger required

Window upper bound (inclusive), non-negative integer. Required. Must be >= from_block.

direction'from' | 'to' | 'any'

Filter sent (from), received (to), or both (any). Defaults to any.

clampstring

When true, truncate an out-of-range window instead of failing with 409 (see above). Any value other than the literal string true is treated as false.

limitinteger

Page size. Absent defaults to 50. 0 or a non-integer value is 400 bad_request. A value above 500 is clamped to 500, not rejected.

cursorstring

Opaque pagination token from the previous response's next_cursor; pass it back unchanged.

Response

This address's transactions.

next_cursorstring

Opaque pagination token from the previous response's next_cursor; pass it back unchanged.

Example response

{
  "data": [
    {
      "block_timestamp": "2026-09-26T05:41:07Z",
      "value": "9007199254740993",
      "gas_price": "9007199254740993",
      "max_fee_per_gas": "9007199254740993",
      "max_priority_fee_per_gas": "9007199254740993",
      "effective_gas_price": "9007199254740993"
    }
  ],
  "meta": {
    "chain": "robinhood_mainnet",
    "chain_slug": "ROBINHOOD_MAINNET",
    "chain_external_id": "eip155:4663",
    "refreshed_at": "2026-09-26T05:41:07Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.