The $19/mo dataset license ships a weekly Parquet (CSV fallback) bulk extract of our free CC BY 4.0 ERC-8004 datasets with a stable, semver-versioned schema contract and a dated change-log per snapshot. This page is the schema contract. The data itself is delivered via a signed URL to subscribers; nothing on this page is paywalled, and the sample rows are illustrative free-tier content.
Subscribe →
What’s shipped under the license
- Weekly extract of the two datasets below as Parquet (CSV fallback if the build host lacks
pyarrow). CHANGELOG.mdper snapshot — rows added, rows removed, and field-level diffs vs the previous snapshot.MANIFEST.json— schema version, format, per-dataset row counts, SHA-256 of each extract file, and the primary key for each dataset.- Stable schema contract versioned by semver with a 30-day deprecation window on breaking changes.
What’s not shipped
Paid-tier evaluation fields — trust_verdict, Sybil-adjusted reputation with tag_breakdown, payment totals and flows, owner handle strings (ens_name, basename, farcaster_handle), co_owned_agents, raw metadata_fields, smart-account fields (aa_wallet, aa_type, …) — are intentionally NOT published under this license. Those are sold under the Pro subscription ($9/mo, see onchainagentintel.io) and the per-call x402 endpoints ($0.01–$0.05, see /services). The extract builder enforces this at write time — if any row carries a denylisted key the build aborts .
chain-liveness
Primary key: (chain, agent_id). One row per indexed ERC-8004 agent on Base or Ethereum.
| Column | Type | Nullable | Description |
|---|---|---|---|
chain | string | no | Chain slug (base or ethereum). |
agent_id | integer | no | ERC-8004 tokenId. |
registry_uri | string | no | CAIP-10 of the IdentityRegistry. |
endpoint_url | string | yes | Resolved endpoint URL as of the probe. |
endpoint_status | integer | yes | HTTP status of the last probe. |
is_live | integer | no | 1 iff endpoint_status == 200. |
is_placeholder_name | integer | no | 1 iff the agent card’s name matched the placeholder-shape predicate. The raw name string is not emitted. |
checked_at | string | yes | ISO-8601 timestamp of the last probe. |
Sample rows
Illustrative only. Drawn from the free CC BY 4.0 chain-liveness dataset.
| chain | agent_id | registry_uri | endpoint_url | endpoint_status | is_live | is_placeholder_name | checked_at |
|---|---|---|---|---|---|---|---|
| base | 19353 | eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 | https://api.onchainagentintel.io/ | 200 | 1 | 0 | 2026-10-07T00:00:00Z |
| base | 24001 | eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 | https://example.org/agent | 404 | 0 | 0 | 2026-10-07T00:00:00Z |
| base | 31117 | eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 | 0 | 1 | |||
| ethereum | 42 | eip155:1:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 | https://research.example.com/ | 200 | 1 | 0 | 2026-10-06T22:00:00Z |
| ethereum | 97 | eip155:1:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 | https://foo.example/ | 502 | 0 | 0 | 2026-10-06T22:00:00Z |
commerce-backed
Rows from reviews that cite a paid job (also called commerce-backed). Field names are unchanged. This is not a list of every agent that has been paid.
Primary key: (chain, agent_id, feedback_index). One row per ERC-8004 ReputationRegistry feedback event that ties back to a real paid Virtuals ACP job or allowlisted ERC-8183 hook contract under our published commerce-backed definition.
| Column | Type | Nullable | Description |
|---|---|---|---|
chain | string | no | Chain slug. |
agent_id | integer | no | ERC-8004 tokenId. |
registry_uri | string | no | CAIP-10 of the IdentityRegistry. |
client_address | string | yes | Lowercased hex of the feedback-emitting wallet. |
feedback_index | integer | no | Reputation registry feedback-sequence index. |
hook_type | string | no | Derived classifier label (e.g. virtuals_acp, self_deployed). |
endpoint | string | yes | Endpoint on the feedback event. |
feedback_uri | string | yes | URI of the feedback artifact. |
score_norm | number | yes | Normalised feedback score (0..1). |
tag1 | string | yes | First event tag. |
tag2 | string | yes | Second event tag. |
block_number | integer | no | On-chain block of the event. |
tx_hash | string | yes | Transaction hash. |
log_index | integer | no | Log index within the block. |
created_at | integer | no | Unix seconds. |
Sample rows
Illustrative only. Drawn from the free CC BY 4.0 commerce-backed dataset.
| chain | agent_id | client_address | feedback_index | hook_type | endpoint | score_norm | block_number | created_at |
|---|---|---|---|---|---|---|---|---|
| base | 19353 | 0xabc0000000000000000000000000000000000001 | 0 | virtuals_acp | https://api.onchainagentintel.io/v1/audit | 0.95 | 42000000 | 1759795200 |
| base | 24001 | 0xabc0000000000000000000000000000000000002 | 0 | self_deployed | https://example.org/pay | 0.80 | 42000500 | 1759795800 |
| base | 24001 | 0xabc0000000000000000000000000000000000003 | 1 | self_deployed | https://example.org/pay | 0.80 | 42010000 | 1759801200 |
| base | 19353 | 0xabc0000000000000000000000000000000000004 | 1 | virtuals_acp | https://api.onchainagentintel.io/v1/audit | 1.00 | 42010500 | 1759802000 |
| ethereum | 42 | 0xdef0000000000000000000000000000000000005 | 0 | self_deployed | https://research.example.com/pay | 0.75 | 19500000 | 1759780000 |
Semver policy
The schema is versioned with semver. Breaking changes bump MAJOR and are preceded by a 30-day dual-emit window; additive columns bump MINOR; doc-only fixes bump PATCH. The current version is pinned in MANIFEST.json as schema_version; during a dual-emit window the next-stable version appears alongside as schema_version_next.
| Change | Version bump | Deprecation window |
|---|---|---|
| New column added | MINOR (e.g. 1.0.0 → 1.1.0) | None required — additive |
| Column type or semantics changed | MAJOR | 30 days on dual-emit |
| Column removed | MAJOR | 30 days on dual-emit |
| Column renamed | MAJOR | 30 days on dual-emit (old + new) |
| Docstring / nullability-doc fix | PATCH | None required — doc-only |
Change-log
Every snapshot ships a CHANGELOG.md next to the Parquet / CSV files recording rows added, rows removed, and field-level diffs vs the previous snapshot. The same information is in MANIFEST.json.diff_counts for machine readers. This page tracks the versioned schema itself; snapshot-level diffs live inside each delivered extract.
v1.0.0 — 2026-10-07
- Initial release of the schema contract.
- Datasets:
chain-liveness,commerce-backed. - Column order is fixed by the schema contract.
- JSON Schema:
api.onchainagentintel.io/schema/dataset-licence/v1.0.0.json. - Paid-tier field denylist enforced at write time; builds abort if any row carries a denylisted key.
Reading
| Resource | Purpose |
|---|---|
| /erc-8004-chain-liveness | Source free CC BY 4.0 dataset for the chain-liveness table. Daily snapshot, JSON + CSV. |
| /commerce-backed-agents-dataset | Source free CC BY 4.0 dataset for the commerce-backed table. Daily snapshot, JSON + CSV. |
| /services | Per-call x402 pricing for the paid /v1/intel/* endpoints — the paid-tier evaluation fields that are intentionally not in this extract. |
| /docs | API docs, including the x402 payment flow and USDC EIP-3009 reference. |
Cite as
Content on this page is published under Creative Commons Attribution 4.0 International (CC BY 4.0). The licensed bulk extract itself is delivered under the $19/mo dataset license.
Publisher: Onchain Agent Intel. Canonical URL: onchainagentintel.io/datasets/licence-schema/. Schema version: 1.0.0 · First published 2026-10-07. JSON Schema: api.onchainagentintel.io/schema/dataset-licence/v1.0.0.json.