Agent Price API (AgentShare)
AgentShare is a DeFi-first intelligence API for autonomous AI agents on Solana, with commerce procurement as a secondary module. Responses are structured JSON with freshness and billing metadata so agents can reason about staleness and cost. Always use GET /api/v1/meta, GET /agent.json, and GET /coverage for the live capability list. Primary — DEX Scout & DeFi intelligence GET…
Agent Price API (AgentShare) endpoints
| Method | Endpoint | Description |
|---|---|---|
| public | ||
| GET |
get_meta_api_v1_meta_get /api/v1/meta |
Call first to learn what this API offers. No API key needed. Returns endpoints, features, sources (tiki, shopee, lazada, accesstrade), and auth. Product scope for pricing data… |
| GET |
health_check_api_v1_health_get /api/v1/health |
Process is up. Does not query the database or external services — suitable for load balancers and frequent probes. Response should be sub-50ms under normal load. |
| GET |
get_agent_capabilities_api_v1_agent_capabilities_get /api/v1/agent-capabilities |
Machine-readable capability description for AI agents and automated API discovery. Returns what the API does, available endpoints, data types, and common use cases. |
| products | ||
| POST |
submit_product_url_api_v1_products_submit_post /api/v1/products/submit |
Alpha: suggest a product listing page for catalog coverage. Rate-limited per IP; higher limits with a valid X-API-Key. Does not crawl immediately — submissions are queued for… |
| GET |
get_product_api_v1_products__product_id__get /api/v1/products/{product_id} |
Call when user has a product ID from search and wants full details. Use include_analysis for verdict/recommendation. |
| GET |
get_price_history_api_v1_products__product_id__price_history_get /api/v1/products/{product_id}/price-history |
Call when user asks about price trends or history. Use fields to reduce token. |
| GET |
search_products_api_v1_search_get /api/v1/search |
Call when user asks to compare prices, search products, or find deals. Returns products with prices from multiple sources. Empty result set returns HTTP 200 with `status:… |
| integrations | ||
| GET |
get_aliexpress_affiliate_product_detail_api_v1_integrations_aliexpress_affiliate_product_detail_get /api/v1/integrations/aliexpress/affiliate/product-detail |
Returns rich product data from AliExpress IOP ``aliexpress.affiliate.productdetail.get`` (images, title, prices, shop, affiliate URL). Requires server-side Open Platform app key… |
| offers | ||
| GET |
best_offer_under_budget_api_v1_offers_best_under_budget_get /api/v1/offers/best-under-budget |
Call when user says 'best X under Y million'. Returns best_offer or null if none fits. Use fields to reduce token. |
| GET |
best_offer_api_v1_offers_best_get /api/v1/offers/best |
Call when user asks 'where to buy X cheapest?' or 'best deal for X'. Returns single lowest-price offer. Use include_analysis for verdict/recommendation. |
| MCP Hub | ||
| GET |
mcp_registry_summary_api_v1_public_mcp_registry_summary_get /api/v1/public/mcp-registry/summary |
Compact verified listings for agent consumption. Descriptions are truncated; use HTML /registry or GET /api/v1/registry/entries for full text. |
| GET |
list_registry_entries_api_v1_registry_entries_get /api/v1/registry/entries |
List verified registry entries. Agents should prefer this over HTML. |
| POST |
submit_registry_entry_api_v1_registry_submit_post /api/v1/registry/submit |
Submit a new listing (metadata only). Status pending_review until admin approves. |
| auth | ||
| POST |
register_api_v1_auth_register_post /api/v1/auth/register |
Creates a user and a free-tier API key. Plain key is returned only in this response. |
| GET |
auth_me_api_v1_auth_me_get /api/v1/auth/me |
Requires X-API-Key. Returns key id, plan, and user email if linked. |
| POST |
login_api_v1_auth_login_post /api/v1/auth/login |
Returns account info and key prefix. Full key is only available from /auth/register. |
| openplatform | ||
| POST |
aliexpress_oauth_prepare_api_v1_openplatform_aliexpress_oauth_prepare_post /api/v1/openplatform/aliexpress/oauth/prepare |
Build authorize URL with fresh CSRF ``state``. Requires ``X-Admin-Key``. Set ``ALIEXPRESS_OPEN_STRICT_OAUTH_STATE=true`` and always start from this endpoint in production. |
| GET |
aliexpress_oauth_callback_api_v1_openplatform_aliexpress_callback_get /api/v1/openplatform/aliexpress/callback |
AliExpress redirects here after user authorization. Register this full URL (with production host) in App Console Callback URL. |
| Edge Devices | ||
| GET |
get_edge_device_specs_api_v1_edge_specs__product_id__get /api/v1/edge/specs/{product_id} |
Get detailed specs of an edge device. |
| GET |
get_edge_categories_api_v1_edge_categories_get /api/v1/edge/categories |
Get edge device categories list. |
| GET |
search_edge_devices_api_v1_edge_search_get /api/v1/edge/search |
Search edge devices with specific filters. |
| GET |
get_edge_recommendations_api_v1_edge_recommendations_get /api/v1/edge/recommendations |
Get edge device recommendations by use case. |
| GET |
compare_edge_devices_api_v1_edge_compare_get /api/v1/edge/compare |
Compare multiple edge devices at once. |
| Currency | ||
| GET |
get_exchange_rates_api_v1_currency_rates_get /api/v1/currency/rates |
Get current exchange rates. |
| GET |
convert_currency_api_v1_currency_convert_get /api/v1/currency/convert |
Convert currency. |
| debug | ||
| GET |
debug_payment_config_api_v1_debug_payment_config_get /api/v1/debug/payment-config |
Check if PayPal/VNPay are configured. No auth. Use 127.0.0.1 if localhost returns 404. |
| GET |
test_normalization_api_v1_debug_normalize_get /api/v1/debug/normalize |
Test ProductNormalizer with raw JSON. Requires X-Admin-Key. |
| webhooks | ||
| POST |
register_webhook_api_v1_webhooks_register_post /api/v1/webhooks/register |
Register a new webhook for price alerts. |
| GET |
list_webhooks_api_v1_webhooks_get /api/v1/webhooks |
List all webhooks for the current API key. |
| POST |
test_webhook_api_v1_webhooks_test_post /api/v1/webhooks/test |
Send a test webhook payload. |
| PATCH |
update_webhook_api_v1_webhooks__webhook_id__patch /api/v1/webhooks/{webhook_id} |
Update a webhook. |
| DELETE |
unregister_webhook_api_v1_webhooks__webhook_id__delete /api/v1/webhooks/{webhook_id} |
Unregister a webhook. |
| GET |
get_webhook_deliveries_api_v1_webhooks__webhook_id__deliveries_get /api/v1/webhooks/{webhook_id}/deliveries |
Get delivery history for a webhook. |
| Dashboard | ||
| GET |
list_api_keys_api_v1_dashboard_api_keys_get /api/v1/dashboard/api-keys |
List API keys for the authenticated user. Returns key_prefix, plan, created_at, last_used. |
| GET |
get_usage_api_v1_dashboard_usage_get /api/v1/dashboard/usage |
Current month usage for the authenticated API key. |
| POST |
revoke_key_api_v1_dashboard_revoke_key_post /api/v1/dashboard/revoke-key |
Revoke an API key. Only keys belonging to the authenticated user can be revoked. |
| coverage | ||
| GET |
coverage_spec_coverage_get /coverage |
Data coverage spec — honesty & transparency for agents. Describes which product categories we cover well (focus) vs. expanding (beta). No auth required. CORS enabled for agent… |
Agent Price API (AgentShare) pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $9 / month | — |
|
| ULTRA Recommended | $39 / month | — |
|
| MEGA | $99 / month | — |
|