# Base Token Lens

Base mainnet (chain 8453) token security and honeypot screening for agents.
Use this service to inspect a token contract before a swap: honeypot signals, sell simulation, privileged controls, buy/sell taxes and liquidity. Independent project; not an audit or safety guarantee.

## Stock Gate
Stock-token agent preflight: https://base-token-lens-phs6048.amazonlightsail.com/stock-gate/llms.txt . Free single/batch stock checks, dedicated OpenAPI and x402 detailed reports. Stock tokens use issuer NAV/multiplier rules rather than ordinary ERC-20 security scoring.

## Discovery
- OpenAPI: https://base-token-lens-phs6048.amazonlightsail.com/openapi.json
- Live payment configuration: https://base-token-lens-phs6048.amazonlightsail.com/api/v1/config
- Registered ACP offering: https://base-token-lens-phs6048.amazonlightsail.com/acp-offering.json
- ACP agent: https://app.virtuals.io/acp/agents/01a1cefc-bd64-7cf5-987a-117e16c5058a?tab=acp

## Bot pre-buy and batch integration
- Guide and JavaScript helper: https://base-token-lens-phs6048.amazonlightsail.com/bots
- GET https://base-token-lens-phs6048.amazonlightsail.com/api/v1/pretrade?address=0x4200000000000000000000000000000000000006
- GET or POST https://base-token-lens-phs6048.amazonlightsail.com/api/v1/batch (1 to 5 token addresses).
These free endpoints return policy decisions (pass/review/block), stable reasons, timestamps and free summaries. eligibleForQuote is true only for pass; it is never a safety guarantee or automatic trade. Missing required evidence and expired results require review. Check each batch item, even on HTTP 200. See /openapi.json for policy bounds and JSON request schema. ACP paid jobs remain single-token.

## Free summary
GET https://base-token-lens-phs6048.amazonlightsail.com/api/v1/scan?address=0x4200000000000000000000000000000000000006
The example address is Base WETH. Replace it with the nonzero 20-byte Base token contract to inspect. The address query parameter is required. No wallet connection or payment is needed for this summary.

## Detailed evidence: two purchase routes
1. Direct HTTP: GET https://base-token-lens-phs6048.amazonlightsail.com/api/v1/report?address=0x4200000000000000000000000000000000000006
Price: 0.001 USDC (1000 atomic units), x402 v2 exact, Base mainnet. Read /api/v1/config for current availability. A 402 response supplies PAYMENT-REQUIRED; use a compatible x402 client and PAYMENT-SIGNATURE. PAYMENT-RESPONSE supplies the settlement result. Detailed results are released after successful settlement. Do not blindly retry ambiguous settlement failures.
2. Virtuals ACP: agent 01a1cefc-bd64-7cf5-987a-117e16c5058a, offering base_token_risk_report, fixed 0.01 USDC, SLA 5 minutes. Requirement JSON: {"address":"0x4200000000000000000000000000000000000006"}. ACP uses its own escrow lifecycle; do not also call the x402 paid route for the same job. Runtime health is independent of this registration document.

## Output and decision semantics
JSON fields include schemaVersion, modelVersion, chain, address, token, checkedAt, expiresAt, assessment, sources and limitations. Free results contain signals; paid reports include checks and evidence.
assessment.riskScore is a rule-based observed-risk index: 0 is lower observed risk, 100 is higher observed risk, null is insufficient evidence. It is not a scam probability. band=unknown is not an approval to trade. Review coveragePercent, source availability, timestamps and unknown checks. A clear signal does not guarantee safety.
Sources: GoPlus Security, Honeypot.is and DEX Screener. Data may be cached up to 60 seconds; DEX and token coverage are incomplete. Base only. No automatic buying or trading.

## Errors
- 400 INVALID_TOKEN_ADDRESS: include a nonzero 0x-prefixed 40-hex-character Base token contract in the address query parameter.
- 402: use the advertised x402 payment requirements for a detailed HTTP report.
- 429: respect Retry-After and back off.
- 503: payment configuration or data unavailable, or insufficient evidence. Do not manufacture a safe rating from an error.
In the HTTP authorization flow, a non-2xx report does not settle. ACP failures follow the platform's separate expiry/dispute process; this is not an automatic refund promise.

Builder code: bc_3fq92q5s, using the x402 builder-code extension (ERC-8021 Schema 2). It does not indicate an official Base endorsement.