Notus API
Blockchain

List Whitelisted Tokens by Project

This endpoint lists all tokens whitelisted by project

GET
/api/v1/crypto/tokens
x-api-key<token>

In: header

Query Parameters

orderBy?string

How to order the tokens

Value in"marketCap" | "chainId"
orderDir?string

Direction of the ordering, ascending or descending.

Value in"asc" | "desc"
search?string

Search a token by its address, name or symbol

filterByChainId?number

Only show tokens from a certain chain. Supported EVM chains:

  • Arbitrum One: 42161
  • Avalanche: 43114
  • Base: 8453
  • BNB Smart Chain: 56
  • Ethereum: 1
  • Gnosis: 100
  • OP Mainnet: 10
  • Polygon: 137
page?integer

Page to return, the "perPage" amount will influence what and how pages are returned

Default1
Range1 <= value
perPage?integer

Amount of tokens returned per page

Default10
Range1 <= value <= 100
projectId?string

The projectId you want to know the whitelist

Response Body

curl -X GET "https://api.notus.team/api/v1/crypto/tokens?orderBy=marketCap&orderDir=asc&search=WBTC&filterByChainId=42161&page=5&perPage=25&projectId=9c0f200f-27b1-4a30-8127-d5e74f136957"
fetch("https://api.notus.team/api/v1/crypto/tokens?orderBy=marketCap&orderDir=asc&search=WBTC&filterByChainId=42161&page=5&perPage=25&projectId=9c0f200f-27b1-4a30-8127-d5e74f136957")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.notus.team/api/v1/crypto/tokens?orderBy=marketCap&orderDir=asc&search=WBTC&filterByChainId=42161&page=5&perPage=25&projectId=9c0f200f-27b1-4a30-8127-d5e74f136957"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.notus.team/api/v1/crypto/tokens?orderBy=marketCap&orderDir=asc&search=WBTC&filterByChainId=42161&page=5&perPage=25&projectId=9c0f200f-27b1-4a30-8127-d5e74f136957"

response = requests.request("GET", url)

print(response.text)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;

HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://api.notus.team/api/v1/crypto/tokens?orderBy=marketCap&orderDir=asc&search=WBTC&filterByChainId=42161&page=5&perPage=25&projectId=9c0f200f-27b1-4a30-8127-d5e74f136957"))
  .GET()
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}
using System;
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var response = await client.GetAsync("https://api.notus.team/api/v1/crypto/tokens?orderBy=marketCap&orderDir=asc&search=WBTC&filterByChainId=42161&page=5&perPage=25&projectId=9c0f200f-27b1-4a30-8127-d5e74f136957");
var responseBody = await response.Content.ReadAsStringAsync();
{
  "tokens": [
    {
      "id": "1370x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6",
      "address": "0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6",
      "name": "Wrapped Bitcoin",
      "symbol": "WBTC",
      "decimals": 8,
      "logo": "https://wbtclogo.com",
      "marketCap": 45445843627,
      "chain": {
        "id": 137,
        "name": "POLYGON",
        "logo": "https://logopolygon.com"
      },
      "isWhitelistedInProject": true
    }
  ],
  "page": 5,
  "totalPerPage": 25,
  "total": 482
}