Skip to main content
The marketplace is a JSON service (no UI) that indexes deployed resources and serves their agent cards. Agents read GET /resources to discover endpoints. It is a Hono service.

​
Health

​
route
​
route
Returns 200 { "ready": true } when ready, 503 otherwise.

​
GET /resources

Returns a JSON array of index records. All filters are optional.
​
string
Exact category match.
​
boolean
true or false.
​
integer
Minimum bond, base-unit integer.
​
integer
Minimum base price, base-unit integer.
​
integer
Maximum base price, base-unit integer.
​
number
Minimum reputation score.
​
number
Minimum uptime.
Base-unit query values are validated as digit strings before being parsed as BigInt. A malformed value returns 400.

​
Index record

​
string
The bytes32 resource id.
​
string
The creator address (optional).
​
string
The ERC-8004 agent id.
​
string
The resource slug.
​
string
​
object
{ model, base, perKB, max }. Amounts are base-unit strings.
​
number
​
number
​
object
{ verified, score }.
​
string
Bonded amount, base-unit string.
​
string
The agent card URL.
​
boolean
BigInt fields (pricing amounts, bond) are serialized as base-unit strings.

​
GET /:resourceId/.well-known/agent-card.json

Serves the validated A2A agent card for a resource. Returns 404 for an unknown resource and 500 if the stored card fails validation.

​
POST /resources

An authenticated publish endpoint (Authorization: Bearer, fail-closed). It runs moderation, bond, probe, mint, and index before listing a resource. Used by the studio’s publish stage, not by discovery clients.