{"status":"ok","data":{"service":"AgentShare","type":"agent_paid_api","description":"Agent-paid API (dual-auth API key or x402) with free discovery and MCP. Secondary: commerce procurement and Solana/Meteora DeFi demos. Agents may propose missing capabilities via request_capability.","version":"1.0.0","capabilities":["agent_paid_dual_auth","mcp_streamable_http","x402_pay_per_request","product_search","price_comparison","best_offer_detection","budget_optimized_offers","price_history_analysis","edge_device_recommendation","edge_device_specifications","currency_conversion","request_capability","capability_gap_intake"],"primary_use_cases":["agent-paid API access with dual-auth","find cheapest product","compare price across marketplaces","recommend edge devices for AI workloads","compare robotics parts and robot battery packs","analyze product price trends","detect good deals","propose a missing MCP capability for human review"],"key_endpoints":{"search":"/api/v1/search","best_offer":"/api/v1/offers/best","best_under_budget":"/api/v1/offers/best-under-budget","product_details":"/api/v1/products/{id}","price_history":"/api/v1/products/{id}/price-history","commerce_quote":"/api/v1/agent/commerce/quote","request_capability":"/api/v1/agent/capabilities/request","edge_search":"/api/v1/edge/search","edge_compare":"/api/v1/edge/compare","edge_recommendations":"/api/v1/edge/recommendations","edge_categories":"/api/v1/edge/categories","currency_rates":"/api/v1/currency/rates","currency_convert":"/api/v1/currency/convert","coverage":"/coverage","mcp_tools":"/api/v1/mcp/tools","aliexpress_affiliate_product_detail":"/api/v1/integrations/aliexpress/affiliate/product-detail?product_ids="},"legal":{"index":"/legal/index.json","terms":"/legal/terms.json","privacy":"/legal/privacy.json"},"authentication":{"type":"api_key","header":"X-API-Key"},"data_characteristics":{"sources":["aliexpress","accesstrade"],"update_model":"scheduled_crawling","freshness_metadata":true,"price_history":true,"comparison_metadata":true},"discovery_urls":{"agent_json":"https://agentshare.dev/agent.json","protocol":"https://agentshare.dev/api/v1/protocol","examples":"https://agentshare.dev/api/v1/examples","changelog":"https://agentshare.dev/changelog.json","for_agents":"https://agentshare.dev/for-agents"},"agent_notes":["Start at agent_json, then GET /api/v1/examples for curl/Python/JS snippets","401/429 errors include signup_url, docs_for_agent_url, retry_after_seconds","Use /search to discover products","Use /offers/best to find cheapest offer","Use /offers/best-under-budget for constrained budgets","If fixed MCP tools are insufficient: POST /api/v1/agent/capabilities/request (or MCP request_capability) — structured gap for human review; no codegen","Check freshness_status and data_status before answering end users","GET /coverage for data scope (focus incl. robotics & robot power)","GET /legal/index.json for Terms + Privacy summaries (agent-friendly)"]},"meta":{"timestamp":1789927743.3676987}}