# RiskDataApi

> Solana token-risk API for trading bots and AI agents.
> Safety score 0-100, insider clusters (shared first-funder), honeypot
> risk, and LP lock status.
>
> Website widget: 3 manual checks/day, no email (humans only).
> API key: 15 calls/day via email, no card.
> x402: $0.02 USDC/call, no key — GET /api/v1/token-risk/x402
> Subscription: $45 / 30 days / 5000 calls, then $0.015/call.

## Agent quick start

1. Connect MCP at https://www.tnt-audit.com/api/mcp
2. Call `check_token_risk` with no key — 5 free anonymous calls/day.
3. Need more: call `get_free_api_key(email)` (15/day free) or pay per call via x402 ($0.02 USDC). Refusals carry `options[]` with the next step.

### Claude Desktop

Add to `claude_desktop_config.json` (uses the `mcp-remote` bridge):

```json
{
  "mcpServers": {
    "riskdataapi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.tnt-audit.com/api/mcp"]
    }
  }
}
```

### Cursor

Add to `~/.cursor/mcp.json` (or project `.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "riskdataapi": {
      "url": "https://www.tnt-audit.com/api/mcp"
    }
  }
}
```

A key can be added as `"headers": {"Authorization": "Bearer <api_key>"}` in Cursor.

Base URL: https://www.tnt-audit.com
Full OpenAPI 3.1 spec: https://www.tnt-audit.com/openapi.json
MCP server (stateless, for MCP-native agents): https://www.tnt-audit.com/api/mcp
Docs: https://www.tnt-audit.com/risk-api/docs
Human docs / pricing / signup: https://www.tnt-audit.com/risk-api

## Core

- [GET /api/v1/token-risk](https://www.tnt-audit.com/openapi.json): Safety score (0-100), insider funding clusters, mint/freeze authority, honeypot risk, LP lock status, and live market data for one Solana mint. Requires `Authorization: Bearer <api_key>`.
- [GET /api/v1/token-risk/x402](https://www.tnt-audit.com/openapi.json): Same response as above, paid per-call via the x402 protocol (HTTP 402 + USDC on Solana) instead of an API key. Built for autonomous agents that don't want to register up front.
- [POST /api/v1/token-risk/batch](https://www.tnt-audit.com/openapi.json): Same lookup for up to 25 mints in one call, run concurrently. N mints = N calls charged, no bulk discount.
- [GET /api/v1/token-risk/history](https://www.tnt-audit.com/openapi.json): Hourly safety-score and market history for a mint, up to 90 days back. Free — reads TNT House's own database, not the live upstream, so it doesn't count against your call quota.

## Getting a key

- [POST /api/v1/signup](https://www.tnt-audit.com/openapi.json): Free-tier API key (15 requests/day) by email, no card. Key is shown once and also emailed as a recovery copy.
- [POST /api/v1/trial/check](https://www.tnt-audit.com/openapi.json): Anonymous trial, no email at all — 3 checks per browser fingerprint before it points you at signup.

## Webhooks

- [POST /api/v1/webhooks/subscribe](https://www.tnt-audit.com/openapi.json): Get a signed callback when a mint's safety score crosses a threshold you set (checked every 15 minutes). Subscription cap depends on tier.
- [GET /api/v1/webhooks/subscribe](https://www.tnt-audit.com/openapi.json): List your own webhook subscriptions.

## Notes for agents

- Every response field is documented in the OpenAPI spec above — read it once rather than guessing field names.
- `cluster_analysis` is `"pending"` on a mint's first-ever check while insider detection runs in the background (usually done within 1-2 minutes); re-check the same mint shortly after for the complete result.
- Rate-limit state is in response headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, and `X-Credit-Balance-Usd` once a key has a paid tier or credit balance.
- x402 is the fastest path for an agent with a Solana wallet and no interest in managing an API key: first call without payment returns 402 with the price and payTo address; retry with a valid payment header.