How to Use FundTracer API

## Introduction to FundTracer API

The FundTracer API allows developers to integrate our powerful blockchain forensics capabilities directly into their applications, services, and workflows. Whether you are building a crypto portfolio tracker, compliance tool, or research dashboard, our API provides the data you need.

Getting Started

Authentication

To use the API, you need an API key. Here is how to get one:

1. Sign up at fundtracer.xyz
2. Navigate to your profile settings
3. Generate a new API key
4. Keep your key secure - never expose it in client-side code

Base URL

All API requests go through: https://api.fundtracer.xyz/v1

Authentication Header

Include your API key in the request header: Authorization: Bearer YOUR_API_KEY

API Endpoints

1. Wallet Analysis

**Endpoint:** GET /wallet/{address}

**Parameters:** - address - The wallet address to analyze - chain - The blockchain network (ethereum, solana, base, etc.)

**Example Request:** curl -X GET "https://api.fundtracer.xyz/v1/wallet/0x742d35Cc6634C0532925a3b844Bc9e7595f5b2a1?chain=ethereum" -H "Authorization: Bearer YOUR_API_KEY"

**Example Response:** { "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f5b2a1", "chain": "ethereum", "balance": "1.5234", "balanceUSD": 2847.32, "riskScore": 45, "labels": ["early-adopter", "defi-user"], "transactions": [...], "tokens": [...], "firstSeen": "2017-06-15" }

2. Transaction History

**Endpoint:** GET /wallet/{address}/transactions

**Parameters:** - address - Wallet address - chain - Blockchain network - limit - Number of transactions (default: 50) - cursor - Pagination cursor

3. Token Holdings

**Endpoint:** GET /wallet/{address}/tokens

Returns all ERC-20/SPL tokens held by the wallet with current values.

4. Funding Tree

**Endpoint:** GET /wallet/{address}/funding-tree

**Parameters:** - depth - How many levels to trace (1-5) - direction - "inbound", "outbound", or "both"

Returns the funding flow visualization data.

5. Risk Score

**Endpoint:** GET /wallet/{address}/risk

Returns detailed risk score breakdown with factors.

6. Sybil Analysis

**Endpoint:** POST /sybil/analyze

**Body:** { "addresses": ["0x...", "0x...", "0x..."], "chain": "ethereum" }

Returns cluster analysis identifying potential Sybil activity.

Code Examples

JavaScript / TypeScript

const axios = require('axios');

const API_KEY = process.env.FUNDTRACER_API_KEY; const BASE_URL = 'https://api.fundtracer.xyz/v1';

async function analyzeWallet(address, chain = 'ethereum') { try { const response = await axios.get( BASE_URL + '/wallet/' + address, { params: { chain }, headers: { Authorization: 'Bearer ' + API_KEY } } ); return response.data; } catch (error) { console.error('Error:', error.response?.data || error.message); } }

// Usage const result = await analyzeWallet('0x742d35Cc6634C0532925a3b844Bc9e7595f5b2a1'); console.log(result.riskScore);

Python

import requests import os

API_KEY = os.getenv('FUNDTRACER_API_KEY') BASE_URL = 'https://api.fundtracer.xyz/v1'

def analyze_wallet(address, chain='ethereum'): headers = {'Authorization': 'Bearer ' + API_KEY} params = {'chain': chain} response = requests.get( BASE_URL + '/wallet/' + address, headers=headers, params=params ) return response.json()

# Usage result = analyze_wallet('0x742d35Cc6634C0532925a3b844Bc9e7595f5b2a1') print(result['risk_score'])

Rate Limits

| Plan | Requests/minute | Daily Limit | |------|-----------------|-------------| | Free | 10 | 100 | | Pro | 60 | 10,000 | | Max | 200 | Unlimited |

Best Practices

1. Cache Results

Do not make API calls for the same wallet repeatedly. Cache results for at least 5-10 minutes.

2. Handle Errors Gracefully

try { const data = await analyzeWallet(address); } catch (error) { if (error.response?.status === 429) { // Rate limited - wait and retry await sleep(60000); } else if (error.response?.status === 404) { // Wallet not found } }

3. Use Webhooks for Large Scale

For monitoring many wallets, use webhooks instead of polling.

4. Secure Your API Key

Never commit API keys to version control. Use environment variables.

Use Cases

Compliance Tool

Build automated AML screening by checking wallet risk scores before transactions.

Portfolio Tracker

Add wallet analysis to track portfolio performance and whale movements.

Research Dashboard

Create custom dashboards for on-chain research with historical data.

Alert Systems

Monitor wallets for significant changes and send alerts.

Documentation

Full API documentation is available at fundtracer.xyz/docs/api-reference.

Getting Help

• Check our API Docs
• Join our community
• Contact support for enterprise needs

Conclusion

The FundTracer API provides powerful blockchain forensics capabilities for developers. Whether you are building compliance tools, research dashboards, or consumer apps, our API has you covered.

Get started with a free account at fundtracer.xyz and generate your API key today.