API Reference

This contain all the endpoints, pricing and error codes to access Address Audit service

The GetBlock Address Audit API provides access to all address audit services, which you can integrate into your dApp, including wallet audit, wallet riska nd rug pull checker

Base URL

https://services.getblock.io/v1

Authentication

All requests require an API key in the header:

Authorization: Bearer <API_KEY>

How to Get Address Audit API Key

Go to your account dashboard
Click on the product icon on the Navbar

Scroll down and Select Address Audit
After that, select the API key tab
On the API Key tab, click on the plus icon, and your API key will be generated for you automatically

Ensure you store your API Key securely

QuickStart

In this example, you will be auditing a wallet address:

Axios (JavaScript / Node.js)
Python (Requests library)

Before you begin, you must have already installed npm or yarn on your local machine (for the Axios example) or Python and pip (for the Python example).

Setup project

Create and initialize a new project:

mkdir wallet-audit-quickstart
cd wallet-audit-quickstart
npm init --yes

Install Axios

npm install axios

Create file

Create a new file named index.js. This is where you will make your first call.

Set ES module type

Set the ES module "type": "module" in your package.json.

Add code

Add the following code to index.js:

index.js

import axios from "axios";

const data = 
  {  "network": "ETH", "address": "0xa45f...a675"};

const config = {
  method: "post",
  url: "https://services.getblock.io/v1/wallet-audit/check",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  data: data,
};

axios(config)
  .then((response) => console.log(JSON.stringify(response.data, null, 2)))
  .catch((error) => console.log(error));

Replace <YOUR_API_KEY> with your actual API Key from the GetBlock dashboard.

Run the script

node index.js

Expected output (example):

{
    "data": {
        "message": "Success",
        "walletAddress": "0xa45f...a675",
        "status": "Fraud",
        "probabilityFraud": "0.9329851866",
        "token": null,
        "chain": "ETH",
        "lastChecked": "2026-03-19T07:02:56.000Z",
        "forensic_details": {
            "cybercrime": "0",
            "money_laundering": "0",
            "number_of_malicious_contracts_created": "0",
            "gas_abuse": "0",
            "financial_crime": "0",
            "darkweb_transactions": "0",
            "reinit": "0",
            "phishing_activities": "0",
            "fake_kyc": "0",
            "blacklist_doubt": "0",
            "fake_standard_interface": "0",
            "data_source": "",
            "stealing_attack": "0",
            "blackmail_activities": "0",
            "sanctioned": "0",
            "malicious_mining_activities": "0",
            "mixer": "0",
            "fake_token": "0",
            "honeypot_related_address": "0"
        },
        "checked_times": 3,
        "createdAt": "2026-03-19T06:52:28.000Z",
        "updatedAt": "2026-05-15T17:01:48.000Z",
        "sanctionData": [
            {
                "id": 205813,
                "trustscore_id": 18360032,
                "category": null,
                "name": null,
                "description": null,
                "url": null,
                "isSanctioned": false,
                "createdAt": "2026-05-15T17:01:48.000Z",
                "updatedAt": "2026-05-15T17:01:48.000Z"
            }
        ]
    }
}

Setup the project directory

mkdir wallet-audit-quickstart
cd wallet-audit-quickstart

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate

# On Windows, use:
venv\Scripts\activate

Install requests

pip install requests

Create script

Create a file called main.py with the following content:

main.py

import requests
import json

url = "https://services.getblock.io/v1/wallet-audit/check"

payload = json.dumps({  "network": "ETH", "address": "0xa45f...a675"})

headers = {
      "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json",
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

Replace <YOUR_API_KEY> with your actual GetBlock API Key.

Run the script

python main.py

Next Step

PreviousRug Pull Checker NextWallet Audit Endpoint

Last updated 22 days ago

Was this helpful?