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

walletAddressstring

Smart wallet address to retrieve the history from

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

Query Parameters

take?integer

Maximum amount of transactions per page.

Default100

Range1 <= value <= 100

lastId?string

Cursor for paging. ID of the last transaction from the previous page

type?array<string>

Filter by transaction type

status?array<string>

Filter by transaction status

userOperationHash?string

Filter by a specific user operation hash

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

chains?array<number>

Filter by chains involved in the transaction
Supported EVM chains:

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

chainInId?numberDeprecated

DEPRECATED: Use chains instead. Filter by the chain where the transaction started.

chainOutId?numberDeprecated

DEPRECATED: Use chains instead. Filter by the chain where the transaction ended when it's a cross-chain transaction.

createdAtLatest?string

Latest date to filter transactions

Formatdate-time

createdAtOldest?string

Oldest date to filter transactions

Formatdate-time

metadataKey?string

Metadata key to filter by. Must be used together with metadataValue.

metadataValue?string

Metadata value to filter by. Must be used together with metadataKey.

Response Body

curl -X GET "https://api.notus.team/api/v1/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?take=50&lastId=834ce153-ea11-4e8b-8644-f42814ad1787&type=SWAP&type=CROSS_SWAP&status=COMPLETED&status=FAILED&userOperationHash=0x2aac7a66d5331454eafc9b981be3596ad08a40dad24883e3b9c4a5362cd7f7e1&chains=42161&chains=43114&chainInId=42161&chainOutId=43114&createdAtLatest=2025-02-04T20%3A24%3A47.022Z&createdAtOldest=2024-11-02T21%3A35%3A45.969Z&metadataKey=custom_field&metadataValue=custom_value"

fetch("https://api.notus.team/api/v1/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?take=50&lastId=834ce153-ea11-4e8b-8644-f42814ad1787&type=SWAP&type=CROSS_SWAP&status=COMPLETED&status=FAILED&userOperationHash=0x2aac7a66d5331454eafc9b981be3596ad08a40dad24883e3b9c4a5362cd7f7e1&chains=42161&chains=43114&chainInId=42161&chainOutId=43114&createdAtLatest=2025-02-04T20%3A24%3A47.022Z&createdAtOldest=2024-11-02T21%3A35%3A45.969Z&metadataKey=custom_field&metadataValue=custom_value")

package main

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

func main() {
  url := "https://api.notus.team/api/v1/wallets/0xa2acc967a9fc4fd5d18351d06deb9b8718c18333/history?take=50&lastId=834ce153-ea11-4e8b-8644-f42814ad1787&type=SWAP&type=CROSS_SWAP&status=COMPLETED&status=FAILED&userOperationHash=0x2aac7a66d5331454eafc9b981be3596ad08a40dad24883e3b9c4a5362cd7f7e1&chains=42161&chains=43114&chainInId=42161&chainOutId=43114&createdAtLatest=2025-02-04T20%3A24%3A47.022Z&createdAtOldest=2024-11-02T21%3A35%3A45.969Z&metadataKey=custom_field&metadataValue=custom_value"

  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?take=50&lastId=834ce153-ea11-4e8b-8644-f42814ad1787&type=SWAP&type=CROSS_SWAP&status=COMPLETED&status=FAILED&userOperationHash=0x2aac7a66d5331454eafc9b981be3596ad08a40dad24883e3b9c4a5362cd7f7e1&chains=42161&chains=43114&chainInId=42161&chainOutId=43114&createdAtLatest=2025-02-04T20%3A24%3A47.022Z&createdAtOldest=2024-11-02T21%3A35%3A45.969Z&metadataKey=custom_field&metadataValue=custom_value"

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?take=50&lastId=834ce153-ea11-4e8b-8644-f42814ad1787&type=SWAP&type=CROSS_SWAP&status=COMPLETED&status=FAILED&userOperationHash=0x2aac7a66d5331454eafc9b981be3596ad08a40dad24883e3b9c4a5362cd7f7e1&chains=42161&chains=43114&chainInId=42161&chainOutId=43114&createdAtLatest=2025-02-04T20%3A24%3A47.022Z&createdAtOldest=2024-11-02T21%3A35%3A45.969Z&metadataKey=custom_field&metadataValue=custom_value"))
  .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?take=50&lastId=834ce153-ea11-4e8b-8644-f42814ad1787&type=SWAP&type=CROSS_SWAP&status=COMPLETED&status=FAILED&userOperationHash=0x2aac7a66d5331454eafc9b981be3596ad08a40dad24883e3b9c4a5362cd7f7e1&chains=42161&chains=43114&chainInId=42161&chainOutId=43114&createdAtLatest=2025-02-04T20%3A24%3A47.022Z&createdAtOldest=2024-11-02T21%3A35%3A45.969Z&metadataKey=custom_field&metadataValue=custom_value");
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://logopolygon.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": {
        "token": {
          "name": "Wrapped Bitcoin",
          "symbol": "WBTC",
          "decimals": 18,
          "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f",
          "logoURL": "https://assets.notus.team/wbtc.png"
        },
        "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