/evm/{chain}/txs/job

Call this endpoint with an account address and a block range (startBlock/endBlock) or a timestamp range (startTimestamp/endTimestamp) to retrieve transactions for.

  • If no job exists for the given parameters, a new background job will be started to start fetching transactions, and the API will return a 425 (Too Early) with progress information.
  • If a job is already running but not yet complete, the API will return a 425 (Too Early) with progress information.
  • Once the job finishes, subsequent calls will return a 200 (OK) with paginated transaction data (including standard pagination via nextPageUrl).

To consume results:

  1. Call this endpoint and check for HTTP 200 or HTTP 425.
  2. If you receive HTTP 425, retry periodically until you receive a 200. Alternatively, if you provided a webhookUrl, you will automaticallyreceive a webhook notification when the job finishes processing.
  3. When a 200 is returned, fetch the transactions in the response (which will default to the first 100 transactions) and then call nextPageUrl (if provided) to fetch the remaining pages.

You must supply either both startBlock and endBlock or both startTimestamp and endTimestamp, but not a mix of block and timestamp parameters.

Optional flags let you classify transactions from a different address perspective, exclude spam transactions, include pricing data for tokens, run balance reconciliation checks, or receive a webhook notification when processing completes.

Language
Click Try It! to start a request and see the response here!