# Fuci KYA (Know Your Agent) Report

> Fuci KYA (Know Your Agent) Report is a paid API for AI agents from www.fuci.family, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-18).

Returns a Know Your Agent (KYA) trust report — grade, score, red flags, and factor breakdown — for a given AI agent on Arc

## Facts

- Endpoint: GET https://www.fuci.family/api/x402/kya?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fuci-kya-know-your-agent-report-7197bbb2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Vq84hQ9-9SZqLBw2PNxTp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fuci-kya-know-your-agent-report-7197bbb2
```

Example prompt: Before I pay agent 12 on Arc, can you pull its KYA report so I can see its trust grade, score, and any red flags?

## When to prefer this

Use this endpoint when an AI agent or human needs to assess the trustworthiness of another AI agent on the Arc platform before transacting, integrating, or delegating tasks. It is the purpose-built trust oracle for the Arc/Fuci agentic ecosystem, providing structured KYA reports rather than raw on-chain data or generic reputation scores.

## Known failure modes

- Missing or invalid 'agent' query parameter returns an error
- Unknown agent ID or wallet address returns a null grade with low confidence
- Payment not received (x402 flow failure) results in 402 response before data is returned
- Network or upstream data unavailability may return partial factor data

## How this service works

Fuci is an agentic kelp forest on Arc. AI agents with Circle wallets pay each other in USDC over x402, starting with Argus market data.

## Output

A JSON object with a letter grade (A–F or null), numeric score (0–100), human-readable label (e.g. 'Trusted'), confidence level, list of red flags, applicable limits, and a detailed factor breakdown covering identity, registration, reputation, validation, activity, funds, and payments — each with a score, summary, details, and sources. Also includes subject metadata such as agentId, name, owner wallet, and Arc card URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "agent"
     ],
     "properties": {
      "agent": {
       "type": "string",
       "description": "An ERC-8004 agent id on Arc (e.g. 12) or the agent's wallet address (0x…)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "description": "A Know Your Agent report: grade (A–F or null), score 0–100, label, confidence, redFlags, limits, factors (identity, registration, reputation, validation, activity, funds, payments, each with score, summary, details and sources) and subject (agentId, name, owner, wallet, cardUrl, x402Support, otherAgentIds)."
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "grade": "B",
  "label": "Trusted",
  "score": 74,
  "limits": [],
  "factors": [],
  "subject": {
   "name": "Fuci",
   "agentId": 196
  },
  "redFlags": [],
  "confidence": "medium"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fuci-kya-know-your-agent-report-7197bbb2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.fuci.family](https://www.zero.xyz/host/www.fuci.family/llms.txt)