The $29/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.
pyarrow).CHANGELOG.md per 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.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 ($19/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 (pinned by test_0758_dataset_licence_extract.py).
chain-livenessPrimary 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. |
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-backedPrimary 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 the canonical predicate at smartcontractauditpro/commerce_backed.py.
| 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. |
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 |
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 |
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.
chain-liveness, commerce-backed.LICENCE_SCHEMA (dict insertion order) in smartcontractauditpro/dataset_licence_extract.py.api.onchainagentintel.io/schema/dataset-licence/v1.0.0.json.PAID_FIELDS_DENYLIST) enforced at write time; builds abort if any row carries a denylisted key.| 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. |
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 $29/mo dataset license.