Notus API
Liquidity pools

List Liquidity Pools

List liquidity pools that exist on the blockchain. The pool can be in a broken state, like having nearly no liquidity. Use the data returned by this endpoint to asses if the pool is worth investing into. Choose the aggregation interval to control both granularity and time range: DAILY (last 30 days), WEEKLY (last 12 weeks), MONTHLY (last 12 months).

GET
/api/v1/liquidity/pools
x-api-key<token>

In: header

Query Parameters

object

Response Body

curl -X GET "https://api.notus.team/api/v1/liquidity/pools?=%5Bobject+Object%5D"
fetch("https://api.notus.team/api/v1/liquidity/pools?=%5Bobject+Object%5D")
package main

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

func main() {
  url := "https://api.notus.team/api/v1/liquidity/pools?=%5Bobject+Object%5D"

  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/liquidity/pools?=%5Bobject+Object%5D"

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/liquidity/pools?=%5Bobject+Object%5D"))
  .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/liquidity/pools?=%5Bobject+Object%5D");
var responseBody = await response.Content.ReadAsStringAsync();
{
  "pools": [
    {
      "provider": {
        "name": "XY",
        "logoUrl": "https://assets.notus.team/Lifi.png",
        "explorerURL": "https://explorer.li.fi"
      },
      "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "chain": {
        "id": 137,
        "name": "POLYGON",
        "logo": "https://logopolygon.com"
      },
      "fee": 0.05,
      "totalValueLockedUSD": "10000.453",
      "tokens": [
        {
          "name": "Wrapped Bitcoin",
          "symbol": "WBTC",
          "decimals": 18,
          "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f",
          "logoURL": "https://assets.notus.team/wbtc.png"
        }
      ],
      "stats": {
        "rangeInDays": 30,
        "feesInUSD": "1500.75",
        "volumeInUSD": "50000.25",
        "transactionsCount": 1250
      }
    }
  ]
}
{
  "statusCode": 403,
  "id": "UNAVAILABLE_COMPUTE_UNITS",
  "message": "The project doesn't have enough compute units to perform this action. Please upgrade your plan."
}
{
  "statusCode": 500,
  "id": "DB_API_FAILED",
  "message": "We had a problem fetching the data from our metadata servers. If the problem persists, contact our support."
}