DEVELOPER INTERFACE

Data API

Deterministic RWA state and events through cacheable JSON and RSS endpoints.

NETWORKROBINHOOD CHAIN CHAIN ID4663 MODEREAD ONLY

DOCUMENTED INTERFACES

One checked catalogue

DYNAMIC RATE LIMIT

120 / 60 SEC

D1-backed API and MCP per anonymous client and edge location

MCP TOOLS

Read-only deterministic operations

CONTRACT

OPENAPI 3.1

Routes, parameters, and statuses

PROFESSIONAL DEVELOPER CENTER

HTTP, exports, feeds, and MCP

Every interface below comes from one endpoint catalogue. Try requests are same-origin, read-only, and bounded to the documented path; dynamic D1-backed responses are rate-limited, while accepted immutable network and pool snapshots are cache-only.

OpenAPI Agent setup truth Field catalog

Core

GET/api/v1/metaService and chain metadata

Version, chain identity, deterministic decision model, and disclaimer.

Response appears here after a same-origin request.

GET/healthFail-closed readiness

Required readiness gates with 200 ready and 503 not-ready semantics.

Response appears here after a same-origin request.

GET/api/v1/healthAPI readiness alias

The same fail-closed readiness contract under the versioned API prefix.

Response appears here after a same-origin request.

GET/api/v1/statusDiagnostics and coverage

Required checks, advisory coverage, jobs, providers, and freshness objectives.

Response appears here after a same-origin request.

Assets

GET/api/v1/assetsCanonical asset registry

Authority-validated identities and the latest source-bound state.

Response appears here after a same-origin request.

GET/api/v1/assets/AAPLOne canonical asset

Identity, state, quote reference, oracle publication, and explorer evidence.

Response appears here after a same-origin request.

GET/api/v1/assets/AAPL/history?range=1MUnderlying OHLCV history

Validated underlying reference-market bars. This is not token venue execution data.

Response appears here after a same-origin request.

GET/api/v1/assets/AAPL/metrics?days=30Per-asset explorer history

Hourly holder, transfer, supply, and explorer metric observations.

Response appears here after a same-origin request.

GET/api/v1/verify/0xaF3D6D6E6b1385A03E1f3A8F3610Dd3DEbDf93f9Verify a contract

Exact-address canonical registry decision with authority evidence.

Response appears here after a same-origin request.

GET/api/v1/tokens/0xaf3d6d6e6b1385a03e1f3a8f3610dd3debdf93f9Exact token record

Canonical, classified, or indexed token evidence by exact Chain 4663 contract address; registry authority absence is unavailable, never noncanonical.

Response appears here after a same-origin request.

GET/api/v1/pools/{address}Exact pool snapshot

Accepted immutable pool snapshot by exact Chain 4663 contract address, with explicit not-indexed and unavailable states.

Open resource

Analytics

GET/api/v1/metricsCanonical RWA analytics

Coverage-labeled canonical, classified-chain, value, and network context.

Response appears here after a same-origin request.

GET/api/v1/networkNetwork Watch snapshot

Accepted immutable first-party Network Watch snapshot; no database, RPC, explorer, or aggregator fallback is used.

Response appears here after a same-origin request.

GET/api/v1/classificationClassification aggregates

Exact-address RWA, documented-launchpad memecoin, and unclassified series.

Response appears here after a same-origin request.

GET/api/v1/classification/tokens?category=CLASSIFIED_MEMECOIN&limit=25Classification evidence

Paginated exact-contract records with explicit population scope.

Response appears here after a same-origin request.

GET/api/v1/issuanceIssuance reconciliation

Contract supply, Blockscout observations, and deterministic supply events.

Response appears here after a same-origin request.

GET/api/v1/collisions?page=1&pageSize=25Ticker collision ledger

Searchable and paginated exact-ticker evidence at non-canonical addresses.

Response appears here after a same-origin request.

GET/api/v1/listingsListing chronology

Canonical first-observed registry records and listing event IDs.

Response appears here after a same-origin request.

GET/api/v1/pegVenue and peg evidence

Fixed-block venue observations with explicit identity, liquidity, TWAP, and reference gates.

Response appears here after a same-origin request.

GET/api/v1/tvlDual-methodology TVL

DeFi-net and total-assets methodology projections with an explicit unavailable state when the accepted coverage cut is incomplete.

Response appears here after a same-origin request.

Shadow Analytics

GET/api/v1/intelligence/{surface}Evidence-bound analytical publication (disabled)

Feature-gated Event Spine, Oracle Health, Venue Basis, RPI, or OHI contract. Every response remains unlisted/noindex and carries freshness, coverage, methodology, units, and explicit gaps.

DISABLED No live destination promoted

GET/data/intelligence/manifest.jsonAnalytical dataset manifest (disabled)

Feature-gated links for the matching API, self-describing CSV, scriptless embed, page, and MCP contracts for all five shadow analytical surfaces.

DISABLED No live destination promoted

GET/data/intelligence/{surface}.csvSelf-describing analytical CSV (disabled)

Bounded spreadsheet-safe evidence with an always-present metadata row followed by exact records.

DISABLED No live destination promoted

GET/embed/intelligence/{surface}.svgScriptless analytical status embed (disabled)

Accessible noindex SVG summary of the same bounded surface cut.

DISABLED No live destination promoted

Events

GET/api/v1/events?page=1&pageSize=25Complete event archive

Paginated deterministic registry, state, oracle, corporate-action, provider, and network events.

Response appears here after a same-origin request.

GET/api/v1/actions?limit=100Corporate actions

Scheduled and applied multiplier transitions.

Response appears here after a same-origin request.

GET/updates.json?limit=25Verified publication history

Successful truth-gated public briefs and alerts with source hashes and delivery IDs.

Response appears here after a same-origin request.

Protocol APIs

GET/api/v1/protocolsProtocol catalog (quarantined)

Returns 503 until a production-verified protocol source is accepted.

QUARANTINED No live destination promoted

GET/api/v1/protocols/{slug}Protocol record (quarantined)

Returns 410 for explicitly retired synthetic slugs and 503 for other valid slugs.

QUARANTINED No live destination promoted

GET/api/v1/where-usedWhere Used graph (quarantined)

Returns 503 while protocol publication remains quarantined.

QUARANTINED No live destination promoted

GET/api/v1/protocol-metrics/definitionsProtocol metric dictionary (quarantined)

Returns 503 while protocol publication remains quarantined.

QUARANTINED No live destination promoted

GET/api/v1/protocol-metrics/definitions/{metric_id}Protocol metric definition (quarantined)

Valid metric IDs return 503 while protocol publication remains quarantined.

QUARANTINED No live destination promoted

GET/api/v1/watchProtocol/network watch (disabled)

Returns 404 feature_disabled; the accepted repository cut is not promoted as live state.

DISABLED No live destination promoted

GET/api/v1/watch/eventsWatch events (disabled)

Returns 404 feature_disabled; no live incident feed is claimed.

DISABLED No live destination promoted

GET/api/v1/watch/reportWatch report (disabled)

Returns 404 feature_disabled; no live report is claimed.

DISABLED No live destination promoted

Feeds

GET/rss.xmlRSS event feed

Filterable RSS 2.0 event delivery.

Open RSS

GET/calendar.icsCorporate-actions calendar

Named iCalendar download and subscription surface.

Open ICAL

Exports

GET/tokenlist.jsonSigned canonical token list

Uniswap-compatible list with P-256 signature metadata.

Response appears here after a same-origin request.

GET/data/latest.jsonCurrent state snapshot

Redistributable canonical identity and onchain-state export.

Response appears here after a same-origin request.

GET/data/latest.csvCurrent state CSV

Named flat export with spreadsheet-formula neutralization.

Open CSV

GET/data/classification.jsonClassification snapshot

Current methodology, coverage, sources, and daily series.

Response appears here after a same-origin request.

GET/data/classification.csvClassification CSV

Daily RWA, classified memecoin, and unclassified observations.

Open CSV

GET/data/peg.jsonPeg evidence snapshot

Current venue evidence, gates, and rejection reasons.

Response appears here after a same-origin request.

GET/data/peg.csvPeg evidence CSV

Flat named export of per-asset eligibility.

Open CSV

GET/data/collisions.csvCollision CSV

Filtered collision ledger export.

Open CSV

GET/data/events.csvBounded filtered event CSV

Exact filtered rows from one snapshot up to 5,000 rows and 8,388,608 encoded bytes; 413 above either limit. Apply filters in the event center first.

Build bounded export

GET/data/address-labels.jsonAddress labels

Canonical and exact-ticker collision labels with identity warnings.

Response appears here after a same-origin request.

GET/data/manifest.jsonArchive manifest

Daily snapshot index with content hashes.

Response appears here after a same-origin request.

Contracts

GET/openapi.yamlOpenAPI 3.1 contract

Canonical machine-readable HTTP interface contract.

Open YAML

POST/mcpStreamable HTTP MCP

Read-only Model Context Protocol server with deterministic tools.

Open MCP

SDK distribution status

V0.2 TECHNICAL

JavaScript and Python SDK v0.2 sources are vendored for repository and offline integration-kit use; v0.2 is not published to a registry.

LEGACY PRODUCTION

V0.1 PACKAGES ARE LIVE. npm provides @chain4663/client 0.1.x and PyPI provides chain4663 0.1.0.

PINNED LEGACY INSTALLATION

npm i @chain4663/client@0.1.1 or pip install chain4663==0.1.0. Use the checked-out repository or checksum-verified copied kit for v0.2.

COPYABLE QUICKSTART

Use the canonical asset endpoint

Command linecurl

curl --fail --show-error \
  -H 'accept: application/json' \
  'https://chain4663.com/api/v1/assets/AAPL'

Browser or NodeJavaScript

const response = await fetch('https://chain4663.com/api/v1/assets/AAPL');
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const asset = await response.json();

Research notebookPython

import requests
response = requests.get('https://chain4663.com/api/v1/assets/AAPL', timeout=10)
response.raise_for_status()
asset = response.json()

MODEL CONTEXT PROTOCOL

Connect the read-only MCP server

Streamable HTTP endpoint: https://chain4663.com/mcp. No account or bearer token is required. Public rate limits still apply. The Codex example below is UNVERIFIED; see the exact client evidence matrix.

LIVE LEGACY CATALOG

Codex CLI — UNVERIFIEDShell

codex mcp add chain4663 --url https://chain4663.com/mcp

Initialize request — protocol fixtureJSON-RPC

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"research-client","version":"1.0.0"}}}

DISCOVERY

Initialize, send notifications/initialized, then call tools/list. Tool input schemas are returned by the server.

SAFETY

All tools are read-only. Request bodies, batch length, and aggregate tool calls are bounded.

IDENTITY

Contract decisions require exact address evidence; ticker similarity never establishes canonical identity.

PUBLIC FIELD CATALOG

Meaning, units, and proof boundary

Core public asset and event fields. OpenAPI currently defines routes, parameters, and statuses; the field catalog and methodology define response meaning and proof boundaries while exhaustive response schemas are completed.
ENTITY	FIELD	TYPE	MEANING	PROOF
Asset	`canonicalAddress`	0x address	Accepted exact contract identity	Official registry plus StockFactory quorum
Asset	`registryUid`	bytes32	Authority identity key	Official API and onchain StockFactory mapping
Asset	`state.blockNumber`	integer	Fixed quorum observation block	Two independent HTTPS RPC origins
Asset	`state.uiMultiplier`	uint256 string	Current display multiplier	Canonical contract call at fixed block
Asset	`state.totalSupplyUI`	uint256 string	Display-adjusted contract supply	Canonical contract call at fixed block
Asset	`market.price`	decimal string	Underlying reference-market quote	Source URL and source timestamp; never token venue price
Asset	`feed.status`	enum	Published oracle evidence state	Feed contract, round timestamp, heartbeat, and gates
Event	`id`	sha256 hex	Deterministic normalized event identity	Canonical normalized payload
Event	`blockHash`	bytes32	Onchain block provenance where applicable	Quorum or explicitly attributed explorer source
Event	`transactionHash`	bytes32	Origin transaction where applicable	Normalized event evidence
Event	`observedAt`	ISO 8601	CHAIN4663 observation time	Stored immutable event record
Event	`evidence`	object	Source-specific normalized proof	Source URLs, hashes, old/new values, and limitations

CACHING

Responses disclose Cache-Control. Live state uses short edge caching; archival records use stable identifiers.

ERRORS

400 invalid input, 404 unknown record, 429 rate limit, 502 invalid upstream evidence, and 503 failed readiness or protection.

SUPPORT

Report interface drift or source corrections to contact@chain4663.com.