--- name: api.8k4protocol.com description: api.8k4protocol.com exposes three read-only snapshot endpoints for the 8K4 Protocol: aggregate protocol statistics (agent counts, validation totals, scoring distribution), per-chain RPC provider health metrics (success/error rates, latency), and individual agent trust scores (confidence tier, risk band). All endpoints return current point-in-time data with no historical series or streaming capability. host: api.8k4protocol.com --- # api.8k4protocol.com 8K4 Protocol is a multi-chain agent registry and scoring system operating across Base, BSC, and Ethereum. This host serves agents and operators that need to inspect protocol health, evaluate RPC provider reliability, or assess the trustworthiness of a specific registered agent before interacting with or delegating to it. It is distinct from general blockchain data providers in that it focuses exclusively on 8K4's own agent registry and validation infrastructure. ## When to use this host Use this host when an agent needs to evaluate 8K4 Protocol infrastructure health or assess the trustworthiness of a specific registered agent by ID. It is the correct choice for pre-delegation risk checks within the 8K4 ecosystem. Do not use it for historical time-series data, live streaming metrics, bulk agent scoring, or any on-chain transaction data — it only provides current snapshots of 8K4's own registry and RPC statistics. For general blockchain data, block explorers, or token metrics, use a dedicated chain data provider instead. ## Capabilities ### Protocol Aggregate Stats Provides a current snapshot of protocol-wide metrics including total registered agents, validation counts, scoring distribution, and per-chain agent breakdowns. Useful for dashboards or health checks at the protocol level. - **`fetch-8k4-protocol-stats`** — Returns a snapshot of 8K4 protocol statistics including total agents, validation counts, scoring distribution, and per-chain agent breakdowns. ### RPC Provider Health Returns per-chain RPC provider performance data including success and error counts, average response latency, and last error details across Base, BSC, and Ethereum. Used to monitor infrastructure reliability. - **`fetch-protocol-metrics`** — Returns per-chain RPC provider performance metrics for the 8k4 protocol, including success/error counts, average response time, and last error details across Base, BSC, and Ethereum. ### Agent Trust Evaluation Looks up the trust score, confidence tier, and risk band for a single agent by ID, enabling pre-interaction risk assessment of specific 8K4 Protocol agents. - **`fetch-agent-trust-score`** — Returns the 8K4 Protocol trust and performance score for a specified agent ID, including confidence tier, risk band, chain, and timestamp. ## Workflows ### Protocol Health and Agent Vetting *Use when an agent needs to assess overall protocol health before deciding whether to trust a specific agent ID within that protocol.* 1. **`fetch-8k4-protocol-stats`** — Retrieve aggregate stats to confirm the protocol has sufficient validated agents and acceptable score distribution before proceeding. 2. **`fetch-protocol-metrics`** — Check per-chain RPC provider health to confirm the chain hosting the target agent has acceptable success rates and latency. 3. **`fetch-agent-trust-score`** — Look up the specific agent's trust score, confidence tier, and risk band to make a final interaction or delegation decision. ## Skill reference ### `fetch-8k4-protocol-stats` **8K4 Protocol Stats** — Returns a snapshot of 8K4 protocol statistics including total agents, validation counts, scoring distribution, and per-chain agent breakdowns. *Use when:* Use when an agent needs current aggregate metrics about the 8K4 protocol, such as total registered agents, validation totals, score averages, confidence tier counts, or chain-level agent distribution across Base, BSC, and Ethereum. *Not for:* Do not use for historical time-series data or liquidity/performance metrics; the response is a single current snapshot with no historical series or liquidity fields. **Returns:** Returns a JSON object with total_agents, total_validations, scored_agents, average_score, confidence tier counts, new_count, and a chains breakdown for base, bsc, and eth. **Example:** `GET https://api.8k4protocol.com/stats` --- ### `fetch-protocol-metrics` **8k4 Protocol Metrics** — Returns per-chain RPC provider performance metrics for the 8k4 protocol, including success/error counts, average response time, and last error details across Base, BSC, and Ethereum. *Use when:* Use when an agent needs to monitor or report on 8k4 protocol RPC provider health, query success/failure rates, average response latency, or the most recent error messages per chain. *Not for:* Do not use for real-time streaming metrics or live block data; this is a snapshot of aggregated provider statistics, not a live feed. **Returns:** Returns a metrics array where each object describes one RPC provider's chain, cumulative success and error counts, average response latency in ms, last error string, and last success and update timestamps. **Example:** `GET https://api.8k4protocol.com/metrics` --- ### `fetch-agent-trust-score` **8K4 Agent Score** — Returns the 8K4 Protocol trust and performance score for a specified agent ID, including confidence tier, risk band, chain, and timestamp. *Use when:* Use when an agent needs to evaluate the trustworthiness or risk profile of a specific 8K4 Protocol agent by ID before interacting with or delegating to it. *Not for:* Do not use for bulk scoring of many agents in a single call; this endpoint scores one agent per request. Not suitable for real-time streaming score updates — this is a single-shot lookup. **Inputs:** - `agent_id` (integer, required) — Numeric ID of the agent whose trust and performance score is being requested. Embedded in the URL path. **Returns:** Returns a JSON object with the agent's numeric score, confidence tier (e.g. NEW), risk band (e.g. HIGH), chain, global CAIP ID, validator count bucket, and score timestamp. **Example:** `GET https://api.8k4protocol.com/agents/21480/score` ---