# Trust Engine API

> Evaluate the risk and trustworthiness of phone numbers, crypto tokens, and property addresses.

Trust Engine is a stateless scoring API that analyzes inputs against real-time fraud intelligence (IPQS + libphonenumber for phone numbers) and returns a structured trust assessment. Designed for LLM tool calling, agent frameworks, and x402-native paid access.

## Who should use this

- AI agents and LLM tool-calling (OpenAI, Anthropic, Gemini, open models)
- Agent frameworks (LangChain, LangGraph, CrewAI, Vercel AI SDK, Mastra)
- Any app that needs to decide whether an inbound phone number is a scam, spam, or safe — before calling it, texting it, or trusting it

## Integration recipes

See https://trustscore.dev/for-agents for copy-paste recipes for OpenAI function calling, Anthropic tool use, LangChain, LangChain.js, and Vercel AI SDK.

## API Endpoint

POST https://trustscore.dev/api/score

### Request

```json
{
  "type": "phone",
  "input": { "phone_number": "+15551234567" }
}
```

Supported types: phone (live), token (coming soon), property (coming soon)

### Response

```json
{
  "score": 97,
  "confidence": 0.75,
  "signals": { "carrier": "T-Mobile", "is_voip": false, "fraud_score": 0, "..." : "..." },
  "risk_flags": ["Do-not-call registry"],
  "summary": "This number appears trustworthy with a score of 97/100."
}
```

- score: 0–100 (higher = more trustworthy)
- confidence: 0–1 (higher when more data sources contributed)
- risk_flags: human-readable warnings like "VoIP number", "Known spammer", "High fraud score"

## Tool Integration

- OpenAPI spec: https://trustscore.dev/api/openapi
- Function name for tool use: get_trust_score
- Health check: GET https://trustscore.dev/api/health

## Pricing

- `/api/score` — $0.01 USDC on Base per paid call (x402). Free `/api/demo` route for rate-limited evaluation.
- `/api/batch-score` — $0.30 USDC per batch (up to 25 items).

Pay with x402: the API responds with HTTP 402 and a payment-required payload describing the price, network (`eip155:8453`), and pay-to address. Agent wallets settle in one round trip.

## Listed on

- Coinbase x402 Bazaar: https://www.x402.org (category: identity)
- OpenAPI spec: https://trustscore.dev/api/openapi