# GroundTruths Creator Flag API

> GroundTruths Creator Flag API is a paid API for AI agents from api.groundtruths.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns a structured reputation record for a crypto creator, including launch counts, rug rates, failure rates, and whether they are flagged as known-bad.

## Facts

- Endpoint: GET https://api.groundtruths.xyz/x402/v1/flag?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/groundtruths-creator-flag-api-795153de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ketW-PwGOuYlUe8oKX-wS

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 groundtruths-creator-flag-api-795153de
```

Example prompt: Can you pull the GroundTruths record for creator 0xABC123 on the Ethereum chain and tell me their rug rate, failure rate, and whether they're flagged as known_bad? They've launched 12 tokens so far.

## When to prefer this

Use this endpoint when you need a structured, ground-truth historical record of a crypto creator's launch outcomes — specifically rug rates, failure rates, and known-bad status — rather than raw on-chain data you'd have to compute yourself. Prefer this over generic on-chain lookups when you want pre-computed reputation signals for fast agent-level trust decisions.

## Known failure modes

- Unknown creator address returns empty or null record
- Chain parameter mismatch returns no data if wrong network specified
- Invalid or missing creator field causes request failure
- Stale asof timestamp if creator data has not been recently indexed
- known_bad flag may lag real-time events if indexer is behind

## How this service works

GROUNDTRUTH creator record: launches, rugged, died, active, survived, graduated, and the observed-only baseline the known_bad line is drawn from.

## Output

Returns a structured object with the creator's full historical record: number of launches, rugs, deaths, active projects, survivors, graduates, and resolved outcomes, plus computed rug_rate and failure_rate percentages, a boolean known_bad flag, and an asof timestamp indicating when the record was last updated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asof": {
   "type": "string"
  },
  "died": {
   "type": "number"
  },
  "chain": {
   "type": "string"
  },
  "active": {
   "type": "number"
  },
  "rugged": {
   "type": "number"
  },
  "creator": {
   "type": "string"
  },
  "launched": {
   "type": "number"
  },
  "resolved": {
   "type": "number"
  },
  "rug_rate": {
   "type": "number"
  },
  "survived": {
   "type": "number"
  },
  "known_bad": {
   "type": "boolean"
  },
  "failure_rate": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "description": "launched, rugged, died, active, survived, graduated, resolved, rug_rate, failure_rate, known_bad, asof"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/groundtruths-creator-flag-api-795153de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.groundtruths.xyz](https://www.zero.xyz/host/api.groundtruths.xyz/llms.txt)