# PeelSignal

Read-only contract, control, explorer, holder and market discovery for any token address on Robinhood Chain (4663), with separate reviewed identity and Stock Token checks. Four separate panels; eligibility always Not confirmed. No LLM in the rule engine. The application is at https://peelsignal.fun; documentation is at https://docs.peelsignal.fun.

## Coverage and limitations

Partial checks. Registry identity, code, UID, token pause, feed rounds and decimals. No reviewed sequencer adapter.

No proof of reserves, fair execution, liquidity guarantee, or legal permission. Demo fixtures are labeled and never replace a failed source.

## Not assessed by any check

- Transfer fees, taxes, blacklists or honeypot behaviour: no swap or transfer is simulated.
- Source code audit or vulnerability review: explorer verification only reports a published code match.
- Who holds the owner, admin or upgrade keys: onchain addresses are recorded, not their controllers.
- Liquidity locks or vesting held by third-party lockers: only indexed pool figures are recorded.
- Off-chain reserves, custody or backing: issuer documents are linked, not verified.
- Price history, volatility or fair value: only current indexed quotes and reviewed feed rounds are read.
- Team identity, legal status, licensing or personal eligibility to trade.

## For agents

- One observation: GET /api/check?address=<0x...> or POST /api/check with {"address","chainId":4663}. Both create and store a new receipt (HTTP 201) and are rate limited; a 429 or 503 carries Retry-After.
- Read receipt.summary for a one-line headline, receipt.classification, receipt.panels[].status and receipt.checks[] for outcomes, receipt.unknowns for failed reads and receipt.notAssessed for questions never asked. Every figure in the summary also exists as a typed field under receipt.evidence.
- A null field means the read reverted, the record was absent or the source failed; check the matching source in receipt.sources before treating it as a negative finding.

## Documentation

- [Start with the evidence](https://docs.peelsignal.fun/): Inspect a token address, understand the four checks, and keep the receipt.
- [Run your first peel](https://docs.peelsignal.fun/first-peel): Go from a contract address to four checks and a shareable receipt.
- [Find information about any token](https://docs.peelsignal.fun/token-discovery): Use a Robinhood Chain address to read the contract, indexed explorer facts and available market pairs.
- [Read a report](https://docs.peelsignal.fun/read-a-report): Read each panel on its own, then check the evidence and timestamps.
- [Status vocabulary](https://docs.peelsignal.fun/status-vocabulary): The labels have fixed meanings across reports, receipts and documentation.
- [Understand reviewed project identity](https://docs.peelsignal.fun/project-identity): Read the optional source comparison that ties published project claims to a deployed contract.
- [Check contract provenance](https://docs.peelsignal.fun/contract-provenance): Identify a token by its chain and contract address.
- [Check price integrity](https://docs.peelsignal.fun/price-integrity): Read feed conditions without treating a recent price as a safety guarantee.
- [Read exposure evidence](https://docs.peelsignal.fun/exposure-evidence): Find the documents that describe what the token represents.
- [Understand Not confirmed](https://docs.peelsignal.fun/eligibility): The MVP does not confirm a person's access or permission to trade.
- [Read price units correctly](https://docs.peelsignal.fun/price-units): Keep feed decimals, token prices and share prices separate.
- [Check supported coverage](https://docs.peelsignal.fun/coverage): Check any token address and understand which identity and oracle methods have reviewed coverage.
- [Understand source review](https://docs.peelsignal.fun/source-review): Trace a supported check to its evidence and review record.
- [Understand missing evidence](https://docs.peelsignal.fun/unknowns): Distinguish a missing answer from a negative finding.
- [Keep a Risk Check Receipt](https://docs.peelsignal.fun/receipts): Save the evidence, time and policy behind one observation.
- [Read expiry and recheck](https://docs.peelsignal.fun/expiry): Use timestamps to distinguish a stored observation from current conditions.
- [Handle source outages](https://docs.peelsignal.fun/outages): Read unavailable-source results and retry without losing the original observation.
- [Read the machine-readable files](https://docs.peelsignal.fun/machine-readable): Use coverage, policy and receipt JSON to inspect the same evidence as the website.
- [Use the scanner securely](https://docs.peelsignal.fun/security): Understand the read-only boundary and the information a report can contain.
- [Understand what is public](https://docs.peelsignal.fun/privacy): Read what the scanner sends, stores and shares.
- [Service scope and use](https://docs.peelsignal.fun/terms): Understand the scope of the information and how to use the public service.
- [About $PEEL](https://docs.peelsignal.fun/peel-token): The PeelSignal project token, its launch status, and what has been announced.
- [Policy and product changes](https://docs.peelsignal.fun/changelog): Track changes that affect how reports are produced and read.

## Machine-readable files

- [Stock Token coverage](https://peelsignal.fun/coverage.json)
- [Project identity coverage](https://peelsignal.fun/projects.json)
- [Policy 2.2.0](https://peelsignal.fun/policy/2.2.0.json)
- [Receipt schemas v1 to v4](https://peelsignal.fun/receipt.schema.json)
- [Current schema v4](https://peelsignal.fun/schema/4.json)
- [Historical schema v3](https://peelsignal.fun/schema/3.json)
- [Historical schema v2](https://peelsignal.fun/schema/2.json)
- [Historical schema v1](https://peelsignal.fun/schema/1.json)
- [Website transport specification](https://peelsignal.fun/openapi.json) (not a stable public API promise)

Receipts: /r/<address>/<id>; append /json for the unchanged JSON observation. Rechecks create new IDs.