Subscriptions

Delivered data events of one chain; each successful page costs 25 CU.

Only delivered data events, ordered by (block, position in block, replay_epoch). Both block bounds omitted selects the last hour by block time up to delivered_through_block; one omitted bound selects an hour relative to the other. A window longer than 24 hours or from_block after to_block is 400 invalid_request. History is retained for at most 30 days and may restart after storage loss; an older from_block is 422 block_out_of_range. Offline subscriptions can read history. Tokens bind all query parameters. Each account has at most two concurrent queries; the platform storage share is also bounded.

get/push/subscriptions/{subscription_id}/events

Request

  • Base URL: https://api.blockvectra.com/v1
  • URL: https://api.blockvectra.com/v1/push/subscriptions/{subscription_id}/events
  • Auth: API key in header x-api-key

Query parameters

chainstring required

lower(chain_slug), ES-030 rule 10.

from_blockinteger
to_blockinteger
limitinteger
page_tokenstring

Opaque; the other parameters must not change between pages.

Response

One page of delivered events.

next_page_tokenstring nullable required

Changes

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