๐ฎ
Simulations & Forks
๐
Alerts
๐
Analytics
Configuration of API Access
Besides using the Tenderly platform via Dashboard, you can also interact with all of our services via Tenderly API. Youโll want to 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 the 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.1
import axios from "axios";
2
import * as dotenv from "dotenv";
3
โ
4
dotenv.config();
5
โ
6
export const anAxiosOnTenderly = () =>
7
axios.create({
8
baseURL: "https://api.tenderly.co/api/v1",
9
headers: {
10
"X-Access-Key": process.env.TENDERLY_ACCESS_KEY || "",
11
"Content-Type": "application/json",
12
},
13
});
Copied!
Project-related operations
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:
https://dashboard.tenderly.co/account/TENDERLY_USER/project/TENDERLY_PROJECT/And the example of usage:
1
const { TENDERLY_USER, TENDERLY_PROJECT } = process.env
2
const tAxios = anAxiosOnTenderly();
3
const projectBase = `account/${TENDERLY_USER}/project/${TENDERLY_PROJECT}`;
4
const resp = await tAxios.get(`${projectBase}/simulations`);
5
โ
6
console.log(resp.data)
Copied!
Example of the .env file
.env fileBy this time your .
env file (at the root of your npm project) holds these 3 items:1
TENDERLY_PROJECT=...
2
TENDERLY_USER=...
3
TENDERLY_ACCESS_KEY=...
Copied!
Last modified 11d ago