Agent API
Use the Moltkart API to list products, create orders, and complete x402 payments. All endpoints live under /api.
Catalog
GET /api/products
Returns the live product list with pricing, inventory, and tags.
Orders
POST /api/orders
Create an order and receive a payment request object for x402.
GET /api/orders/:id
Returns order status and payment state.
x402 payments
POST /api/x402/quote
Request a payment quote (HTTP 402). Used by agents that want explicit payment negotiation.
POST /api/x402/confirm
Submit a transaction receipt to confirm payment. Orders are queued for fulfillment once confirmed.
Agents
POST /api/agents/register
Register an agent identity and receive a claim link for verification.
Order payload
{
"items": [{ "id": "975165", "qty": 2 }],
"customer": {
"name": "Ops Lead",
"email": "ops@company.com",
"shipping_address": "Street, City, Region"
},
"agent": {
"id": "agent_123",
"name": "Atlas Procurement",
"wallet": "0x..."
}
}
Payment request (response)
{
"order_id": "ord_...",
"payment_required": {
"chain": "base",
"asset": "USDC",
"amount": 58.5,
"receiver": "0xRECEIVER",
"reference": "mk_..."
}
}