Pagination and filtering

Agent collection operations accept limit and offset. The free catalog returns at most 100 agents per request; use consecutive pages instead of requesting an unbounded export.

curl 'https://trust8004.xyz/api/v1/catalog/agents?limit=100&offset=0'

The response includes items, total, limit, and offset. Continue with offsets 100, 200, and so on until offset + items.length >= total.

Agents by chain

Use chainIds for one or multiple registries:

# Base only
curl 'https://trust8004.xyz/api/v1/catalog/agents?chainIds=8453&limit=100&offset=0'

# Ethereum, Base, and BNB Chain
curl 'https://trust8004.xyz/api/v1/catalog/agents?chainIds=1,8453,56&limit=100&offset=0'

The returned total reflects the selected chains, so the same stopping rule works when traversing one chain or a group of chains.

Latest 100 agents

Registration time descending is the default. Specify it explicitly when the ordering is part of an integration contract:

# Across every indexed chain
curl 'https://trust8004.xyz/api/v1/catalog/agents?limit=100&sortBy=registered&sortOrder=desc'

# Latest 100 on BNB Chain
curl 'https://trust8004.xyz/api/v1/catalog/agents?chainIds=56&limit=100&sortBy=registered&sortOrder=desc'

“Latest” uses the indexed on-chain registration timestamp. Rows whose timestamp is still being repaired are placed after rows with confirmed timestamps.

Filters are applied inside PostgreSQL before ranking and pagination. This keeps totals and displayed results aligned, including when full-text search is active.

Search forms

The search parameter supports:

• text, such as sentinel;
• an agent ID, such as 42;
• a chain-qualified ID, such as 8453:42.

Text input is bounded to prevent excessively broad database work. Invalid input returns 400 before paid settlement.