API overview

Base URL

https://trust8004.xyz

Responses use JSON. Public read endpoints do not require an API key today; paid resources negotiate USDC payment through x402.

The free marketplace surface is:

GET /api/v1/catalog/agents
GET /api/v1/catalog/agents/{chainId}:{agentId}

These endpoints currently return the same list and profile representations as their paid counterparts. Bulk access and trust-score breakdowns remain paid.

Stable identifiers

Use (chainId, agentId) as the public identity of an agent. Internal database IDs may appear in responses but should not be persisted as cross-system identifiers.

Request limits

Public routes are protected by bounded query inputs and request throttling. Keep integrations efficient:

• request only the page size you need;
• cache data that changes infrequently;
• use chain filters for scoped experiences;
• retry 429 and transient 5xx responses with exponential backoff and jitter.

Next steps

• Pagination and filtering
• Errors and retries
• x402 payments
• Generated API reference