Documentation - Notus API

This endpoint retrieves a historic list of transactions of a specified smart wallet with filters. it also returns transactions still pending execution on the blockchain.

Authorization

x-api-key<token>

In: header

Path Parameters

accountAbstractionstring

Smart wallet address to retrieve the history from

Match^0x[a-fA-F0-9]{40}$

Query Parameters

object

Response Body

curl -X GET "https://api.notus.team/api/v1/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?=%5Bobject+Object%5D"

fetch("https://api.notus.team/api/v1/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?=%5Bobject+Object%5D")

package main

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

func main() {
  url := "https://api.notus.team/api/v1/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?=%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/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?=%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/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?=%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/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?=%5Bobject+Object%5D");
var responseBody = await response.Content.ReadAsStringAsync();

{
  "nextLastId": "f1d61925-d4ae-450a-9f74-ab55f5e6647b",
  "transactions": [
    {
      "metadata": {
        "key": "value"
      },
      "id": "f1d61925-d4ae-450a-9f74-ab55f5e6647b",
      "createdAt": "2025-08-20T19:32:23.581Z",
      "updatedAt": "2025-08-20T20:45:12.385Z",
      "status": "COMPLETED",
      "transactionHash": {
        "hash": "0x68232841f033cf0d9420b0197d667058ab463ed5a524b544f9d016576ca8e2fb",
        "explorerURL": "https://polygonscan.com/tx/0x68232841f033cf0d9420b0197d667058ab463ed5a524b544f9d016576ca8e2fb",
        "explorer": "PolygonScan"
      },
      "chain": {
        "id": 137,
        "name": "POLYGON",
        "logo": "https://polygonlogo.com"
      },
      "type": "CRYPTO_DEPOSIT",
      "userOperationHash": "0x2aac7a66d5331454eafc9b981be3596ad08a40dad24883e3b9c4a5362cd7f7e1",
      "receivedBy": "0xa2acc967a9fc4fd5d18351d06deb9b8718c18333",
      "receivedFromAddress": "0xeca5dd1bfbdd52fb9d94438d2ea4d27acae33b72",
      "receivedCryptoCurrency": {
        "name": "Wrapped Bitcoin",
        "symbol": "WBTC",
        "decimals": 18,
        "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f",
        "logoURL": "https://assets.notus.team/wbtc.png"
      },
      "receivedAmount": {
        "cryptoCurrency": {
          "name": "Wrapped Bitcoin",
          "symbol": "WBTC",
          "decimals": 18,
          "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f",
          "logoURL": "https://assets.notus.team/wbtc.png"
        },
        "amount": "3342.7389263",
        "amountIn": {
          "btc": "1234.98765",
          "eth": "1234.98765",
          "ltc": "1234.98765",
          "bch": "1234.98765",
          "bnb": "1234.98765",
          "eos": "1234.98765",
          "xrp": "1234.98765",
          "xlm": "1234.98765",
          "link": "1234.98765",
          "dot": "1234.98765",
          "yfi": "1234.98765",
          "usd": "1234.98765",
          "aed": "1234.98765",
          "ars": "1234.98765",
          "aud": "1234.98765",
          "bdt": "1234.98765",
          "bhd": "1234.98765",
          "bmd": "1234.98765",
          "brl": "1234.98765",
          "cad": "1234.98765",
          "chf": "1234.98765",
          "clp": "1234.98765",
          "cny": "1234.98765",
          "czk": "1234.98765",
          "dkk": "1234.98765",
          "eur": "1234.98765",
          "gbp": "1234.98765",
          "gel": "1234.98765",
          "hkd": "1234.98765",
          "huf": "1234.98765",
          "idr": "1234.98765",
          "ils": "1234.98765",
          "inr": "1234.98765",
          "jpy": "1234.98765",
          "krw": "1234.98765",
          "kwd": "1234.98765",
          "lkr": "1234.98765",
          "mmk": "1234.98765",
          "mxn": "1234.98765",
          "myr": "1234.98765",
          "ngn": "1234.98765",
          "nok": "1234.98765",
          "nzd": "1234.98765",
          "php": "1234.98765",
          "pkr": "1234.98765",
          "pln": "1234.98765",
          "rub": "1234.98765",
          "sar": "1234.98765",
          "sek": "1234.98765",
          "sgd": "1234.98765",
          "thb": "1234.98765",
          "try": "1234.98765",
          "twd": "1234.98765",
          "uah": "1234.98765",
          "vef": "1234.98765",
          "vnd": "1234.98765",
          "zar": "1234.98765",
          "xdr": "1234.98765",
          "xag": "1234.98765",
          "xau": "1234.98765",
          "bits": "1234.98765",
          "sats": "1234.98765"
        }
      }
    }
  ]
}

{
  "statusCode": 403,
  "id": "UNAVAILABLE_COMPUTE_UNITS",
  "message": "The project doesn't have enough compute units to perform this action. Please upgrade your plan."
}

{
  "statusCode": 404,
  "id": "ACCOUNT_ABSTRACTION_ADDRESS_NOT_REGISTERED_WITH_PROJECT",
  "message": "The requested wallet \"0x335e110f9aa64deef43b646b4bdf90aac3c7844c\" is not registered with the project"
}

Get Smart Wallet History

Authorization

Path Parameters

Query Parameters

Response Body

200

403

404