API Overview

Integrate the CryptMax47 wallet auditing capabilities into your project. Query wallet metrics, detect target networks, evaluate threat markers, and perform deep AI risk assessments programmatically.

Base Production URL:

Production Base URL

https://web-production-51d374.up.railway.app

Authentication

Authorize your requests by including the x-api-key custom header in every request. Obtain keys in the app dashboard settings.

HTTP Headers

x-api-key: YOUR_KEY

cURL Example:

Request Snippet

curl -H
            "x-api-key: YOUR_KEY" https://web-production-51d374.up.railway.app/detect/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4
          

Rate Limits

Limits are applied per hour based on your active plan tier. Exceeding limits returns HTTP 429 Errors.

Plan	Hourly Rate Limit	Monthly Limit Cap	Price
Free Plan	60 calls / hour	1,000 calls	$0 / month
Pro Plan	10,000 calls / hour	500,000 calls	$9 / ₹299
Business Plan	50,000 calls / hour	5,000,000 calls	Custom Quote

GET /detect/{address}

Detects the underlying network family (Bitcoin vs Ethereum) for a public key address format.

Parameter	Type	Requirement	Description
address	string	required	The target wallet address inside the URL path.

curl -H "x-api-key: YOUR_KEY"
            https://web-production-51d374.up.railway.app/detect/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4

import requests

            url = "https://web-production-51d374.up.railway.app/detect/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4"
            headers = {"x-api-key": "YOUR_KEY"}
            response = requests.get(url, headers=headers)
            print(response.json())

            fetch("https://web-production-51d374.up.railway.app/detect/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4", {
            headers: { "x-api-key": "YOUR_KEY" }
            })
            .then(res => res.json())
            .then(data => console.log(data));

JSON Response Example

{ "chain": "bitcoin", "chain_info": { "name": "Bitcoin Mainnet", "symbol": "BTC", "type": "UTXO" } }

GET /analyze/{address}/summary

Returns aggregate totals of sent value, received value, current balance, and coin statistics. Returns distinct shapes depending on the chain type.

Parameter	Type	Requirement	Description
address	string	required	Target public key address in the URL path.

curl -H "x-api-key: YOUR_KEY"
            https://web-production-51d374.up.railway.app/analyze/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/summary

import requests

            url = "https://web-production-51d374.up.railway.app/analyze/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/summary"
            headers = {"x-api-key": "YOUR_KEY"}
            response = requests.get(url, headers=headers)
            print(response.json())

            fetch("https://web-production-51d374.up.railway.app/analyze/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/summary", {
            headers: { "x-api-key": "YOUR_KEY" }
            })
            .then(res => res.json())
            .then(data => console.log(data));

JSON Response Shape (Bitcoin)

{ "received": 528000000, "sent": 420000000, "balance": 108000000, "chain": "bitcoin" }

JSON Response Shape (Ethereum)

{ "received_wei": 2500000000000000000, "sent_wei": 1200000000000000000, "balance_eth": 1.3, "chain": "ethereum" }

GET /analyze/{address}/risk

Returns AI-powered risk scoring audit analyzing mixers, high-volume entities, and exploits. Requires Pro API key.

Parameter	Type	Requirement	Description
address	string	required	Target address in the URL path.

curl -H "x-api-key: YOUR_KEY"
            https://web-production-51d374.up.railway.app/analyze/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/risk

import requests

            url = "https://web-production-51d374.up.railway.app/analyze/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/risk"
            headers = {"x-api-key": "YOUR_KEY"}
            response = requests.get(url, headers=headers)
            print(response.json())

            fetch("https://web-production-51d374.up.railway.app/analyze/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/risk",
            {
            headers: { "x-api-key": "YOUR_KEY" }
            })
            .then(res => res.json())
            .then(data => console.log(data));

JSON Response Example

{ "score": 12, "level": "Low", "summary": "Mainly standard exchanges and liquidity pool interactions detected.", "flags": ["high_liquidity_exchanges"], "ai_enhanced": true }

GET /address/{address}/whale-check

Checks if the wallet balance exceeds the 1,000 BTC/ETH threshold and lists movement anomalies.

Parameter	Type	Requirement	Description
address	string	required	Target address in the URL path.

curl -H "x-api-key: YOUR_KEY"
            https://web-production-51d374.up.railway.app/address/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/whale-check

import requests

            url = "https://web-production-51d374.up.railway.app/address/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/whale-check"
            headers = {"x-api-key": "YOUR_KEY"}
            response = requests.get(url, headers=headers)
            print(response.json())

            fetch("https://web-production-51d374.up.railway.app/address/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/whale-check",
            {
            headers: { "x-api-key": "YOUR_KEY" }
            })
            .then(res => res.json())
            .then(data => console.log(data));

JSON Response Example

{ "is_whale": true, "balance_btc": 1420.5, "activity_score": 85, "anomalies": ["dormant_activation", "round_number_transfers"] }

GET /eth/address/{address}/summary

Returns dedicated Ethereum balance data, wei totals, and mainnet transactions count.

Parameter	Type	Requirement	Description
address	string	required	Ethereum hexadecimal address in the URL path.

curl -H "x-api-key: YOUR_KEY"
            https://web-production-51d374.up.railway.app/eth/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/summary
          

import requests

            url =
            "https://web-production-51d374.up.railway.app/eth/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/summary"
            headers = {"x-api-key": "YOUR_KEY"}
            response = requests.get(url, headers=headers)
            print(response.json())

            fetch("https://web-production-51d374.up.railway.app/eth/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/summary",
            {
            headers: { "x-api-key": "YOUR_KEY" }
            })
            .then(res => res.json())
            .then(data => console.log(data));

JSON Response Example

{ "received_wei": 1420000000000000000000, "sent_wei": 420000000000000000000, "balance_wei": 1000000000000000000000, "balance_eth": 1000.0, "transaction_count": 48 }

GET /address/{address}/quick-risk

Returns standard rule-based risk evaluation instantly. Available on all plans (Free Tier inclusive).

Parameter	Type	Requirement	Description
address	string	required	Target address in the URL path.

curl -H "x-api-key: YOUR_KEY"
            https://web-production-51d374.up.railway.app/address/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/quick-risk

import requests

            url = "https://web-production-51d374.up.railway.app/address/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/quick-risk"
            headers = {"x-api-key": "YOUR_KEY"}
            response = requests.get(url, headers=headers)
            print(response.json())

            fetch("https://web-production-51d374.up.railway.app/address/3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4/quick-risk",
            {
            headers: { "x-api-key": "YOUR_KEY" }
            })
            .then(res => res.json())
            .then(data => console.log(data));

JSON Response Example

{ "score": 45, "level": "Medium", "flags": ["high_tx_count", "recent_activity"] }

POST /reports/generate

Generates and compiles a downloadable PDF Wallet Audit Report. Requires Business plan.

Parameter	Type	Requirement	Description
address	string	required	Provide in JSON request body. Target wallet address.
chain	string	required	Provide in JSON request body: `"bitcoin"` or `"ethereum"`.

curl -X POST -H "x-api-key: YOUR_KEY" -H "Content-Type:
            application/json" -d '{"address": "3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4", "chain": "bitcoin"}'
            https://web-production-51d374.up.railway.app/reports/generate --output report.pdf

import requests

            url = "https://web-production-51d374.up.railway.app/reports/generate"
            headers = {"x-api-key": "YOUR_KEY", "Content-Type": "application/json"}
            payload = {"address": "3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4", "chain": "bitcoin"}

            response = requests.post(url, headers=headers, json=payload)
            with open("report.pdf", "wb") as f:
            f.write(response.content)

fetch("https://web-production-51d374.up.railway.app/reports/generate", {
            method: "POST",
            headers: {
            "x-api-key": "YOUR_KEY",
            "Content-Type": "application/json"
            },
            body: JSON.stringify({ address: "3K9KZZPB8NRwZVP5wNKX4VYhnswrJxpgZ4", chain: "bitcoin" })
            })
            .then(res => res.blob())
            .then(blob => {
            const url = window.URL.createObjectURL(blob);
            const a = document.createElement("a");
            a.href = url;
            a.download = "report.pdf";
            a.click();
            });

Response format

Binary stream: application/pdf payload

GET /market/prices

Returns real-time conversion exchange pricing for Bitcoin and Ethereum coins against requested fiat tickers.

Parameter	Type	Requirement	Description
vs	string	optional	Target fiat conversion symbol in query (defaults to `"usd"`). e.g., `"eur"`, `"inr"`.

curl -H "x-api-key: YOUR_KEY"
            https://web-production-51d374.up.railway.app/market/prices?vs=usd

import requests

            url = "https://web-production-51d374.up.railway.app/market/prices?vs=usd"
            headers = {"x-api-key": "YOUR_KEY"}
            response = requests.get(url, headers=headers)
            print(response.json())

fetch("https://web-production-51d374.up.railway.app/market/prices?vs=usd", {
            headers: { "x-api-key": "YOUR_KEY" }
            })
            .then(res => res.json())
            .then(data => console.log(data));

JSON Response Example

{ "vs_currency": "usd", "bitcoin": { "usd": 67200.5 }, "ethereum": { "usd": 3520.2 } }

Try It Live Sandbox

Submit live network detection requests directly to our production server from this interface:

Awaiting API nodes response...

Response Output:

{ "status": "Ready. Click 'Send Request' to execute." }

Error Codes

Details of returned statuses and error patterns when requests fail:

HTTP Code	Error Flag	Description
400 Bad Request	invalid address	Address does not conform to valid BTC/ETH formats.
401 Unauthorized	invalid key	API key missing or rejected.
403 Forbidden	plan insufficient	Your plan tier lacks permission for this endpoint.
429 Too Many Requests	rate limited	Exceeded hourly limits for your key.
500 Server Error	server error	Node pipeline or upstream services failed.

SDKs & Libraries

Pre-packaged clients to quickly start integrating CryptMax47 into your project:

Python SDK v0.1.0

Native Python wrapper supporting async endpoints, local type checking, and models. Coming Soon

JavaScript SDK v0.1.0

Pure JS/TS client for browsers and Node.js. Supports full typescript typing schemas. Coming Soon

API Documentation

API Overview

Authentication

Rate Limits

Try It Live Sandbox

Error Codes

SDKs & Libraries