Create wallet risk analyses from your own workflow.

API v1 lets teams add Tri-Proof intelligence to their own product: run ScamGuard before a wallet interaction, analyze campaign wallets before rewards, and retrieve clear decisions their users or operations team can act on.

Open API index Choose API access View sample report

Authentication

Use an API Starter or API Growth key in the Authorization header.

Create, copy, and revoke personal keys in Dashboard → Developer. API usage is metered against the active monthly plan.

Create analysis

POST /api/v1/analyze

Queues the wallet list into the same batch worker used by the dashboard.

Read status

GET /api/v1/analysis/ANALYSIS_ID

Returns summary counts, top wallet decisions, clusters, graph intelligence and export URLs.

ScamGuard scan

POST /api/v1/scamguard/scan

Scans URLs, wallets, token mints and pre-sign transaction intent through one endpoint.

Integration path

From plan to first protected request.

The API is sold as a 30-day access plan. The payment activates a request allowance; you then create the key yourself in the dashboard.

Choose API access

Select API Starter for a small integration and 5,000 monthly requests, or API Growth for higher volume, signed webhooks, and priority support.

Pay and open Developer

After a USDC or SOL payment activates the plan, sign in and open Dashboard > Developer.

Create a private key

Name the key, copy it once, and store it in your backend environment. Never place it in browser code or a public repository.

Call the matching endpoint

Use ScamGuard scans before a click or signature. Use wallet-list analysis before campaign rewards, allowlists, grants, or loyalty distributions.

Wallet or dApp

Call ScamGuard before showing a signature prompt, then display the decision, strongest evidence, and next action to the user.

Campaign platform

Submit participant wallets for Sybil analysis, review uncertain wallets, and use the completed decision list before distribution.

Launchpad or quest app

Check claim URLs, token or contract targets, and transaction intent before users connect a wallet or proceed.

Create analysis example

Submit wallets and choose a risk policy.

curl -X POST https://triproofprotocol.com/api/v1/analyze \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "chain": "Solana",
    "projectName": "Solana Campaign Audit",
    "campaignType": "Airdrop",
    "riskPolicy": "balanced",
    "analysisMode": "onchain",
    "wallets": [
      {
        "walletAddress": "Ch8kCo2FW4HXQMTm2wpbLeaVZJxXa4Rg8S4KVXUxcdVm",
        "referrerAddress": "7VgXv5XxRrP9DziP5Q3WmH4r7iKL3JZ7W4PB7XqqNmMu",
        "referralCode": "COMMUNITY-26"
      },
      "DJt9LW4Mma6q5dgE7gXaVmHi8Msjcax1D4wQ78RCDfcw"
    ]
  }'

Automate events

API Growth can notify your backend with signed webhooks when configured analysis events occur.

Verify the signature before changing eligibility, sending rewards, or triggering an internal review workflow.

Status example

Poll until the analysis status is completed.

curl https://triproofprotocol.com/api/v1/analysis/ANALYSIS_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

ScamGuard example

Scan before a wallet or dApp asks the user to sign.

curl -X POST https://triproofprotocol.com/api/v1/scamguard/scan \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "transaction",
    "chain": "evm",
    "value": "{\"method\":\"eth_sendTransaction\",\"data\":\"0x095ea7b3ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\"}",
    "walletAddress": "0x0000000000000000000000000000000000000000"
  }'

URL Sandbox example

Passively inspect HTML and compare Scam DNA across campaigns.

curl -X POST https://triproofprotocol.com/api/v1/scamguard/scan \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "url",
    "chain": "solana",
    "value": "https://project.example/rewards"
  }'

# URL responses include metadata.sandbox and metadata.scamDna.
# The server performs passive HTML analysis and never executes page JavaScript.

Feedback example

Feed false positives and scam reports back into ScamGuard review.

curl -X POST https://triproofprotocol.com/api/scamguard/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "scanId": "SCAN_ID",
    "verdict": "false_positive",
    "reason": "Official project domain confirmed by team."
  }'