Token Details API › Quickstart guide

The Token Details API demo will walk you through how users can seamlessly retrieve and display token price changes from the past week.

Prerequisites

Node.js and npm installed
Basic knowledge of JavaScript, React, and Express.js

Set up environment variables

To securely manage your API key, store it as an environment variable. For macOS:

Open the Terminal.

Add API_KEY variable to your shell configuration file. Replace your_api_key with your DevPortal API key:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           export API_KEY=your_api_key

Save and reload your configuration file:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           source ~/.zshrc  # For zsh (default for macOS)

Step 1: Initialization

Create a new directory for the project:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           mkdir token-details && cd token-details

Initialize a new Node.js project:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           npm init -y

Install Express, CORS, and Axios:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           npm install express cors axios

Create a new file api.js and set up a basic Express server by pasting into it the following:


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
           
 
           
           const express = require("express");
const axios = require("axios");
const cors = require("cors");
const path = require("path");

const app = express();
const PORT = 5001;

app.use(cors()); // To handle CORS issues when making requests to the front end

// Serve static files from the React app
app.use(express.static(path.join(__dirname, "client/build")));

// Add endpoint handler here

// We will route all other requests to the client build
app.get("*", (req, res) => {
  res.sendFile(path.join(__dirname, "client/build", "index.html"));
});

app.listen(PORT, () => {
  console.log(`Server is running on http://localhost:${PORT}`);
});

Add an endpoint to fetch token prices:


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
           
 
           
           const BASE_URL = "https://api.1inch.com/token-details/v1.0/charts/interval";
const CHAIN_ID = 1; // Eth

app.get("/api/:tokeAddress/prices/:interval", async (req, res) => {
  const { tokeAddress, interval } = req.params;

  try {
    const constructedUrl = `${BASE_URL}/${CHAIN_ID}/${tokeAddress}?interval=${interval}`;

    const response = await axios.get(constructedUrl, {
      headers: {
        Authorization: `Bearer ${process.env.API_KEY}`
      }
    });

    // Send the data from the API back to the client
    res.json(response.data.d);
  } catch (error) {
    console.error("Axios Error: ", error.response);
    res.status(500).json({ error: "Failed to fetch token price by interval" });
  }
});

Step 2: Setting up React frontend

Create a new React application:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           npx create-react-app client

Navigate to the React application directory and install React Charts:


         
         
           Bash
         
 
         
         
           
           
             1
2
           
 
           
           cd client
npm i react-charts

Create a component TokenPrice.js inside the src directory with the following content:


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
           
 
           
           import React, { useState, useEffect } from "react";
import { Chart } from "react-charts";

const TokenPrice = ({ address, interval }) => {
  const [tokenPrices, setTokenPrices] = useState([]);
  const [isLoading, setLoading] = useState(false);

  const primaryAxis = React.useMemo(() => ({ getValue: (datum) => datum.date }), []);

  const secondaryAxes = React.useMemo(() => [{ getValue: (datum) => datum.price }], []);

  useEffect(() => {
    const fetchData = async () => {
      setLoading(true);

      const response = await fetch(`http://localhost:5001/api/${address}/prices/${interval}`);

      if (!response.ok) {
        console.log("Fetch token prices error", response);
        return;
      }

      const prices = await response.json();

      setTokenPrices(prices);
      setLoading(false);
    };

    if (isLoading) {
      return;
    }

    fetchData();
  }, [address, interval]);

  if (isLoading) {
    return <div>Loading...</div>;
  }

  if (tokenPrices.length === 0) {
    return <div>No data available</div>;
  }

  return (
    <Chart
      options={{
        data: [
          {
            data: tokenPrices.map((d) => ({
              date: new Date(d.t * 1000),
              price: d.v
            }))
          }
        ],
        primaryAxis,
        secondaryAxes
      }}
    />
  );
};

export default TokenPrice;

Import and use TokenPrice in src/App.js:


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
           
 
           
           import "./App.css";
import TokenPrice from "./TokenPrice";

function App() {
  return (
    <div
      className="App"
      style={{
        width: 800,
        height: 800
      }}
    >
      <h1>Token Price</h1>
      <TokenPrice address="0x111111111117dC0aa78b770fA6A738034120C302" interval="7d" />
    </div>
  );
}

export default App;

Step 3: Running the project

Start the Express server:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           node api.js

In a new terminal, navigate to the client directory and start the React app:

Now, you can view your 1inch token price over last week at http://localhost:3000.

Described above is a basic setup and you can expand upon this by adding more features, error handling, and styling to get to production.

Prerequisites

Set up environment variables

Step 1: Initialization

Step 2: Setting up React frontend

Step 3: Running the project

Did you find what you need?