Configuration of API Access

Besides using the all-in-one Tenderly development platform via the Dashboard, you can also interact with all of our services via Tenderly API. Use the API when you need to do things such as programmatically creating a Fork, retrieving all Forks you have created in your project, running simulation batches, and so on, or perhaps simulate the execution of an arbitrary transaction.

Get an API key

To get your Access Token, go to Settings > Authorization and click on Create Access Token. If you want to create an organization token you can do so from your organization’s settings page.
The token you get will be used in API authentication.
Do not share the API Access token freely.

Configure your API client

The token must be sent via X-Access-Key HTTP header.
Here’s an example of configuring Axios to work with Tenderly, assuming you’ll use dotenv to store your secrets.
import axios from "axios";
import * as dotenv from "dotenv";
export const anAxiosOnTenderly = () =>
baseURL: "",
headers: {
"X-Access-Key": process.env.TENDERLY_ACCESS_KEY || "",
"Content-Type": "application/json",
With Tenderly API you can either do operations that are related to your particular project or a specific Fork. In this case, you’ll also need to specify your project’s slug and the user: TENDERLY_USER and TENDERLY_PROJECT.
You can extract it from the dashboard URL and place these in a safe place:
Here's an example of usage:
const { TENDERLY_USER, TENDERLY_PROJECT } = process.env
const tAxios = anAxiosOnTenderly();
const projectBase = `account/${TENDERLY_USER}/project/${TENDERLY_PROJECT}`;
const resp = await tAxios.get(`${projectBase}/simulations`);

Example of the .env file

By this time your .env file (at the root of your npm project) holds these 3 items: