JEPETA / DOCUMENTATION

Risk intelligence
without the guesswork.

Use Jepeta as a human scanner or as a read-only pre-trade guard inside an autonomous agent. The public preview requires no API key, wallet connection or signature.

API v4.0.0Base · 8453GET onlyNo API keyRead-only

Start in 60 seconds Try the live scanner

01 / QUICKSTART

One endpoint. One exact contract.

Send the exact Base ERC-20 contract address. Jepeta returns a strict preview with a machine decision, raw risk signals, source status and uncertainty.

GET https://aitgmgfumsdqecmanrab.supabase.co/functions/v1/jepeta-risk-scan

JavaScript

const tokenAddress = '0x...';

const response = await fetch(
  'https://aitgmgfumsdqecmanrab.supabase.co/functions/v1/jepeta-risk-scan' +
  '?tokenAddress=' + encodeURIComponent(tokenAddress)
);

const risk = await response.json();
if (!response.ok) throw new Error(risk.code || 'SCAN_UNAVAILABLE');

if (risk.decision === 'BLOCK') {
  // Stop your execution path.
}

console.log(risk.decision, risk.data_quality);

cURL

curl -sS \
  "https://aitgmgfumsdqecmanrab.supabase.co/functions/v1/jepeta-risk-scan?tokenAddress=0x..."

# decision: PASS | WARN | BLOCK
# no Authorization header required

Important: Use the exact token contract, not a ticker symbol. Unknown honeypot or mintability evidence does not become “false”; Jepeta returns HTTP 422 instead.

02 / DECISIONS

Three outputs. No fake certainty.

The decision is a policy hint, not a prediction and not permission to trade.

PASS

No configured warning or block observed.

Useful as a low-friction policy signal, but never a safety guarantee. Source quality and warnings still matter.

WARN

Material review condition observed.

Inspect the exact signal before proceeding. Typical examples include mintability or elevated concentration.

BLOCK

Hard stop condition observed.

Designed for conditions such as an explicit honeypot signal. Your execution policy should stop or escalate.

PASS ≠ safe. Contracts, liquidity and source coverage can change after the scan.

03 / RESPONSE

What comes back.

The public contract is intentionally narrow. Paid-only evidence is not leaked into the free response.

Jepeta public preview response fields
Field	Type	Meaning
`decision`	PASS · WARN · BLOCK	Machine policy hint.
`risk_score`	0–100	Observed heuristic score, not loss probability.
`is_honeypot`	boolean	Explicit GoPlus honeypot signal.
`is_mintable`	boolean	Explicit GoPlus mintability signal.
`buy_tax_percent`	number · null	Observed buy tax when available.
`sell_tax_percent`	number · null	Observed sell tax when available.
`top10_holder_concentration_percent`	number · null	Observed sum from up to ten holder records.
`lp_locked_percent_observed`	number · null	Observed lock coverage in the sampled LP-holder records.
`liquidity_usd`	number · null	Largest exact matching Base pair returned by DEX Screener.
`data_quality`	HIGH · MEDIUM · LOW	How complete the usable evidence is.
`source_status`	object	GoPlus + DEX Screener availability state.
`warnings`	string[]	Human-readable observed concerns and caveats.

Example 200 response +

{
  "schema_version": "4.0.0",
  "chain_id": 8453,
  "token_address": "0x...",
  "decision": "WARN",
  "risk_score": 35,
  "risk_level": "MEDIUM",
  "is_honeypot": false,
  "is_mintable": true,
  "buy_tax_percent": null,
  "sell_tax_percent": null,
  "data_quality": "MEDIUM",
  "source_status": {
    "goplus": "OK",
    "dexscreener": "OK"
  },
  "warnings": [
    "GoPlus reports that token supply can be minted."
  ],
  "observed_at": "2026-09-22T12:00:00Z"
}

04 / HTTP API

Public preview contract.

MethodGET

ChainBase · 8453

AuthNone

CacheShort token cache

Query parameter

tokenAddressrequired

Exact Base ERC-20 contract address. Must match ^0x[a-fA-F0-9]{40}$.

Errors & retry behavior

400Invalid requestBad or malformed token address.

405Method not allowedPublic scanning is GET / OPTIONS only.

422Insufficient coverageRequired GoPlus coverage or explicit honeypot/mintable boolean is unavailable.

429Rate limitedHonor the Retry-After header before retrying.

503Required source unavailableNo assessment is issued when the required security provider is unavailable.

Fail closed:Missing required security evidence produces an explicit error. Jepeta does not silently convert unknown evidence into a reassuring PASS.

05 / FULL REPORTS

Free decision. Paid evidence when it matters.

The public preview answers “stop, review, or continue with your own policy.” Full reports add deeper evidence.

HUMAN

Telegram Stars

Open the full report flow in @Jepeta_bot. The bot shows the current Stars price, purchase terms and invoice before payment.

Open Telegram checkout ↗

AUTONOMOUS AGENT

Virtuals ACP · 0.03 USDC

The paid Token Risk Scan adds dangerous permissions, liquidity-risk assessment, concentration analysis, 24h activity and a structured evidence summary.

Open ACP offering ↗

Dangerous permissionsLiquidity riskHolder concentration24h activityFull warningsEvidence summary

06 / MACHINE REFERENCES

Raw contracts, when you actually want them.

These files are intentionally machine-first. Humans can stay on this page; agents and tooling can consume the raw contracts directly.

OPENAPIopenapi.json

Strict request, response and error contract.

AGENTagent.json

Agent identity, public preview and commerce metadata.

LLMllms.txt

Compact machine-readable integration guide.

LLM FULLllms-full.txt

Extended agent-facing operational context.

SAMPLEsample-full-report.json

Shape of the paid evidence report.

GUIDEBase risk guide

Human explanation of honeypot and related risk signals.

READY TO TEST IT?

Start with one contract.

No account. No wallet. No signature.

Open the free scanner →

Risk intelligencewithout the guesswork.