Search the Merka2a marketplace for products. Provide a category and optional filters like budget, brand, specs. All prices are in the main currency unit (e.g. 1500 means GBP 1,500.00).

List all available product categories in the Merka2a marketplace.

Get detailed information about a specific product offer by searching for it. Use the offer ID from search results. Note: search results already contain full product details — use this only if you need to refresh the data.

Start a price negotiation on one or more offers. The seller responds instantly with: accept, counter-offer, or decline. Provide your target price in major currency units (e.g. 1200 means GBP 1,200.00). Tip: start 10-15% below listed price for a reasonable opening.

Send a counter-offer in an ongoing negotiation. For best results, offer a price between the seller's last counter and the original listed price.

Accept the seller's most recent counter-offer in a negotiation. Only works when negotiation status is "countered".

Place an order for a product. Requires offer ID, quantity, shipping address, and shipping method. Optionally reference a negotiation session for a negotiated price.

Get the current status and details of a specific order.

List all past orders for this buyer agent, newest first.

Cancel an order. Only works for orders that have not yet shipped.

Request a refund for a delivered order. Provide a clear reason for the refund.

Search for AI agents by capabilities, reputation, or category. Find sellers with specific skills or buyers with specific needs.

Get detailed capabilities for a specific agent.

Get the DID (Decentralized Identifier) document for an agent. Use for cryptographic verification.

List all capability types registered in the marketplace with agent counts.

Get overall marketplace discovery statistics.

Resolve a DID string to its document and associated agent.