Skip to main content

Do I need a paid plan to use the Tenderly API?


Yes. Generating API access tokens and using the Tenderly API are available on the paid plan. To enable them for your account, contact our sales team to schedule a call and discuss upgrading your plan.

How can I generate an API access token for an organization?


To generate an access token, navigate to your organization in the Tenderly Dashboard and open the Access Tokens page.Click Create Access Token, enter a name, choose the scope (All projects or One project), optionally set an expiration date, and click Create Token. Copy the token secret immediately; it is displayed only once.

Why does the API return 404 for a project that exists?


Requests to a project your token doesn’t have access to return 404 Project not found. This happens when a global token or a personal access token targets a restricted project, or when a project token targets any project other than its own. If you get this error for a restricted project, authenticate with a project token scoped to it.

Will restricting a project break my API integrations?


Only if global tokens were reaching it. When you restrict a project, every global token loses access to that project while continuing to work everywhere else. The dashboard warns you with the number of affected tokens before you confirm, so you can create project tokens for those integrations first. Project tokens are unaffected.

How can I fetch the latest block via API?


You can use the following API endpoint to fetch the latest block number. For programmatic transaction simulation, see the Simulation API:
example