# Jepeta Risk Guard

> Base ERC-20 pre-trade risk screening for people and autonomous agents. Free strict JSON preview; deeper evidence report through Virtuals ACP.

Canonical site: https://eliber12.github.io/jepeta-core/

## Core facts

- Network: Base / chain ID 8453.
- Public API: https://aitgmgfumsdqecmanrab.supabase.co/functions/v1/jepeta-risk-scan
- Input: one exact ERC-20 contract address in tokenAddress.
- Public schema: 4.0.0.
- Decision: PASS | WARN | BLOCK.
- PASS is not a safety guarantee or permission to trade.
- GoPlus Security is the required security source.
- DEX Screener supplies exact matching Base market context.
- Unknown required honeypot or mintability values fail closed with HTTP 422.
- Public endpoint is GET-only.
- Server-side rate limiting and a short per-token cache protect upstream quotas.

## Successful response

Required fields include:
- schema_version
- chain_id
- token_address
- decision
- risk_score / risk_level
- is_honeypot / is_mintable
- buy_tax_percent / sell_tax_percent
- top10_holder_concentration_percent
- lp_locked_percent_observed
- liquidity_usd
- data_quality
- source_status
- warnings
- observed_at
- paid_report

Use the OpenAPI document as the authoritative schema.

## Decision handling

- BLOCK: stop automated execution.
- WARN: require additional policy checks or human review.
- PASS: continue only if your own execution policy also permits it.

Never convert null metrics into reassuring zeroes.

## Errors

- 400: invalid request/address; fix input.
- 405: method not allowed; use GET.
- 422: required security evidence unavailable; no usable verdict.
- 429: Jepeta or GoPlus rate limit; back off and honor Retry-After.
- 503: required provider unavailable; do not synthesize PASS.

## Paid report

- Protocol: Virtuals ACP v2.
- Agent: Jepeta Risk Guard.
- Agent ID: 01a0b446-374c-7eb8-8fe8-cd1a9945ea70.
- Provider wallet: 0xefcb0359e2cd6d1ad92cbca1e41c8946b308d7df.
- Offering registry name: token_risk_scan.
- Human label: Token Risk Scan.
- Offering ID: 01a0bb7b-be32-73e8-abe6-1385a115ac16.
- Price: 0.03 USDC.
- Direct ACP profile: https://app.virtuals.io/acp/agent/01a0b446-374c-7eb8-8fe8-cd1a9945ea70

The live full report uses Jepeta decision contract v3. It adds policyVerdict, blockers/review reasons, evidence, source status, security/market/holder context, historical deltas, and compatibility risk fields used by earlier integrations.

## Discovery

- [OpenAPI](https://eliber12.github.io/jepeta-core/openapi.json): public API contract and errors.
- [Agent manifest](https://eliber12.github.io/jepeta-core/agent.json): identity, commerce metadata and safety semantics.
- [agents.json](https://eliber12.github.io/jepeta-core/agents.json): discovery alias.
- [Full agent guide](https://eliber12.github.io/jepeta-core/llms-full.txt): detailed field semantics, examples and policy guidance.
- [Sample paid report](https://eliber12.github.io/jepeta-core/sample-full-report.json): real paid-deliverable shape captured from a live scan.
- [Human scanner](https://eliber12.github.io/jepeta-core/): interactive product.
- [Base honeypot and token-risk guide](https://eliber12.github.io/jepeta-core/base-honeypot-checker.html): crawlable explanation of honeypot checks, related risk signals and limitations.
- [GitHub](https://github.com/eliber12/jepeta-automation): public documentation and machine-contract mirror.
- [Telegram](https://t.me/jepeta_tools): risk-intelligence channel.

## Safety

Jepeta is read-only. It does not connect to a buyer wallet, sign transactions, execute trades, predict prices, or provide an audit or investment recommendation.