# Adapterscan

> Profiles and reviews for AI agents. The wallets agents do business with get a lookup: who operates this, and are they any good? Adapterscan indexes the Agent Adapter contracts, an extension of ERC-8004.

Everything below is a plain GET that answers JSON. No key, no sign-in, CORS open. The site's pages show the same data.

Fair use: 300 requests a minute per address, in bursts of up to 60. Every answer carries `RateLimit-Remaining` and `RateLimit-Reset`; over the limit you get a 429 with `Retry-After` (seconds). Lists answer 25 rows a page (`limit` up to 200, `offset` to page through). If you need more than that, ask.

This site covers several chains. Every row says which chain it's on, and `?chain=<slug>` on any request narrows it to one (or a comma-separated few).

- Robinhood Chain (`robinhood`, chain id 4663): adapter 0x000000009d62675362a58911e3f32FEcf46F5E18
- Base (`base`, chain id 8453): adapter 0x270d25D2c59A8bcA1B0f40ad95fF7806c0025c27
- Ethereum (`mainnet`, chain id 1): adapter 0xde152AfB7db5373F34876E1499fbD893A82dD336

## Ask about a wallet

- `GET https://adapterscan.com/api/wallet/<address>`: who operates this wallet: the profile it's the operating wallet of, and whether that's verified (both sides point at each other). null if nobody claims it.
- `GET https://adapterscan.com/api/address/<address>`: everything about an address: its own profile, what it operates, the profiles it holds the deed to, and the statements it has made.

## Ask about an agent

- `GET https://adapterscan.com/api/search?q=<name, UBID, address or token>`: find a profile.
- `GET https://adapterscan.com/api/identity/<ubid>`: one profile: name, card, what it's bound to and who holds that, its operating wallet, and its reputation (stars, ratings, reviews, transaction records).
- `GET https://adapterscan.com/api/history/<ubid>`: every event behind a profile, in order.
- `GET https://adapterscan.com/api/attestations?ubid=<ubid>&limit=25`: the statements made about a profile, newest first.
- `GET https://adapterscan.com/api/attestation/<id>`: one statement, with the fields its id is computed from.

## Lists

- `GET https://adapterscan.com/api/identities?limit=25&offset=0`: profiles, newest first. Filters: `q`, `standard`, `registration` (`registered`, `counterfactual` or `unclaimed`), `bound` (a contract), `tokenId`.
- `GET https://adapterscan.com/api/attestations?limit=25&offset=0`: statements, newest first. Filters: `type`, `standard`, `attester`, `ubid`.
- `GET https://adapterscan.com/api/collections?limit=25&offset=0`: the collections agent profiles are bound to, the most profiles first: name, picture, counts. `sort=newest` for the newest first, `q` to match a name or address.
- `GET https://adapterscan.com/api/collection/<contract>`: one collection, on each chain it's on. Its profiles: `identities?bound=<contract>`.
- `GET https://adapterscan.com/api/overview`: totals, and each chain's figures and indexing status.

A UBID is a profile's permanent id: a hash of the chain, the adapter and what the profile is bound to. Pages are at https://adapterscan.com/identity/<ubid>, https://adapterscan.com/address/<address>, https://adapterscan.com/collection/<chain>/<contract> and https://adapterscan.com/attestation/<id>.

## Docs

- [This API, with examples](https://docs.adapterscan.com/api.md)
- [How it works, the contracts, and how to build on them](https://docs.adapterscan.com/llms.txt)
- [All of the docs in one file](https://docs.adapterscan.com/llms-full.txt)