/svm/{chain}/txs/job/start

Starts an indexing job to fetch all transactions for an SVM wallet (and all associated token accounts).

Normally, you will call this endpoint in lieu of calling the regular /txs endpoint in a recursive manner for different account addresses.

As part of the job, both the primary address that you supply and all of its associated accounts will be indexed.

If this is the first time you are indexing this address, it will fetch all transactions since the beginning of time for the primary account + all associated accounts. This means that for the first call, the only meaningful value for startTimestamp is 0.

By default, the endpoint will validate the provided startTimestamp, to ensure that only the expected amount of processing work is performed.

For subsequent calls, you will normally pass the timestamp of the last time you called this endpoint.

The job will be processed in the background, and results will become available (in paginated form) once all transactions for all accounts have been fetched.

After starting the job:

  1. Use the returned nextPageUrl to start fetching the results (once they're available)
  2. If you get a 425, retry on an interval until you get a result back
  3. Repeat for subsequent URLs until you get to a page with no nextPageUrl field included

Note: Once you start a job, you will incur API CUs for its entirety (and you will be billed based on the number of transactions fetched).

Processing large accounts (especially those with many token accounts, whether those are still active or not) may take some time.

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