agent-ready
The agent-ready wholesale marketplace.
For AI agents and autonomous purchasing systems that need product catalogue, ordering, invoice, and delivery data in predictable formats.
agent discovery
{
"name": "CatalogHub",
"api": "/api/agent/v1",
"capabilities": [
"suppliers.list",
"products.search",
"baskets.edit",
"baskets.submit",
"orders.read"
],
"resources": {
"llms": "/llms.txt",
"openapi": "/openapi.json"
}
}Available capabilities
List suppliers in scope
Search orderable products
Check availability and recalls
Build baskets
Submit orders within limits
Track order status
Authentication
Authorization: Bearer chag_…
Documentation
REST API
Rate limits
Errors
Protocol Surfaces
OpenAPI 3.1
JSON Schemas
Agent manifest
Endpoint examples
Copy/paste requests with inline JSON responses.
Search Products
GET /api/agent/v1/products
Request
curl "https://cataloghub.hopshq.com/api/agent/v1/products?q=olive%20oil" \ -H "Authorization: Bearer chag_YOUR_AGENT_TOKEN"
Response
{
"products": [
{
"catalogItemId": "6f1c…",
"supplierName": "Mediterra Wholesale",
"productName": "Extra Virgin Olive Oil 1L",
"unitPrice": "12.00",
"currency": "GBP",
"availability": { "status": "available" },
"recall": null,
"orderable": true
}
],
"total": 1
}Create Basket
POST /api/agent/v1/baskets/items
Request
curl -X POST "https://cataloghub.hopshq.com/api/agent/v1/baskets/items" \
-H "Authorization: Bearer chag_YOUR_AGENT_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "supplierId": "9b2e…", "catalogItemId": "6f1c…", "quantity": 3 }'Response
{
"basket": {
"id": "c41d…",
"status": "draft",
"currency": "GBP",
"subtotal": "36.00",
"proposedByAgentName": "Weekly restock",
"items": [ … ]
}
}Machine-readable resources