@algomap/sdk

TypeScript SDK for the AlgoMap API — wallet intelligence for Algorand. Works in Node 18+ and browsers (uses the global fetch, no dependencies).

Install

npm install @algomap/sdk

Usage

import { AlgoMap } from '@algomap/sdk';

const algomap = new AlgoMap({ apiUrl: 'https://algomapp.com' });

const profile = await algomap.wallet('A2VO...');
console.log(profile.riskScore, profile.transactionCount);

const peers = await algomap.counterparties('A2VO...', 10);
const graph = await algomap.graph('A2VO...');
const { results } = await algomap.search('some .algo name');

Point apiUrl at your own instance when self-hosting (defaults to https://algomapp.com, overridable via the ALGOMAP_API_URL env var in Node).

API

| Method | Description | | ------ | ----------- | | wallet(address) | Wallet profile: tx count, risk score, flags, cluster, first/last seen, label | | transactions(address, limit?) | Recent transactions, newest first (max 200) | | counterparties(address, limit?) | Peer wallets ranked by transfer count/volume (max 500) | | assets(address, limit?) | Asset positions and transfer volume (ALGO + ASAs) | | transaction(txid) | Single transaction by hash | | topRisk(limit?) | Highest-risk wallets (max 100) | | graph(address, limit?) | Aggregated local transaction graph (max 500) | | search(query) | Universal search: address, txid, ASA/app ID, NFD name, label | | entityLookup(address) | Address attribution (throws 404 when unknown) |

Errors throw AlgoMapError with a numeric status property (e.g. 404 for unknown wallet/attribution).

License

MIT