{"status":"ok","data":{"schema_version":"1.0","name":"agentshare-protocol-lite","intended_clients":["autonomous_agents","tool_builders","sdk_generators"],"canonical_discovery":"https://agentshare.dev/agent.json","uris":{"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","openapi":"https://agentshare.dev/openapi.json"},"auth":{"type":"api_key","header":"X-API-Key","alternate":"Authorization: Bearer <agshp_…>"},"response_envelope":{"ok":{"status":"ok","data":"object","meta":"object?"},"error":{"status":"error","error":{"code":"string","message":"string","retry_after?":"int (seconds)","retry_after_seconds?":"int (alias on 429)"}}},"error_codes":["MISSING_API_KEY","INVALID_API_KEY","RATE_LIMIT_EXCEEDED","PAYLOAD_TOO_LARGE","OUT_OF_CREDITS","KEY_EXPIRED","NOT_FOUND","INTERNAL_ERROR"],"ax_fields_on_error":["docs_for_agent_url","protocol_url","for_agents_url","examples_url","changelog_url","openapi_url","signup_url","docs_url","suggestion","auth_header_examples","retry_after_seconds"],"response_headers":{"always_on_api_v1":["X-Request-ID","X-AgentShare-Discovery","X-AgentShare-Protocol","X-AgentShare-Examples","X-AgentShare-Changelog","X-AgentShare-Version","Link"],"when_authenticated":["X-RateLimit-Limit","X-RateLimit-Remaining","X-RateLimit-Reset"],"on_429":["Retry-After"]},"rate_limit_guidance":"On HTTP 429, read error.retry_after or retry_after_seconds and Retry-After header; wait then retry with exponential backoff.","notes":["This endpoint is informational and does not grant permissions.","Fetch /api/v1/examples before guessing URL shapes.","401 responses include signup_url for free-tier registration.","DeFi agent routes support ?format=compact and ?fields= for token-efficient payloads.","Commerce routes support ?fields= and ?simple=true (see GET /api/v1/search)."],"compact_format":{"opt_in":{"query":"?format=compact","accept":"application/vnd.agentshare.compact+json","fields":"?fields=comma,separated,keys (flat filter; use compact key names when format=compact)","strip_nulls":"?strip_nulls=true (default on when format=compact)","commerce_simple":"?simple=true on GET /api/v1/search and /offers/* (preset minimal fields)"},"verdict_codes":{"SAFE":"S","CAUTION":"M","AVOID":"R","UNKNOWN":"U"},"verdict_legend":{"S":"SAFE","M":"CAUTION (medium risk)","R":"AVOID (risky)","U":"UNKNOWN"},"profiles":{"meteora_brief":{"schema_version":"agentshare.meteora.brief.v1.compact","top_level":{"sv":"schema_version","v":"verdict (code)","r":"risk_score","f":"flags","res":"result","ev":"evidence","m":"meta"},"result":{"k":"kind","w":"window","sb":"sort_by_effective","t":"top pools"},"pool":{"p":"pool_address","n":"name","tx":"token_x","ty":"token_y","tvl":"tvl USD","r":"risk_score","v":"verdict (code)","f":"flags","fee":"fee_{window}","vol":"volume_{window}","apr":"apr_{window}","ftr":"fee_tvl_ratio_{window}","bs":"bin_step","fp":"fee_pct"}},"solana_dex_brief":{"schema_version":"agentshare.solana.dex.brief.v1.compact","protocol_row":{"s":"slug","v24":"volume_24h_usd","c1":"change_1d_pct","h":"highlight"}},"meteora_pool_detail":{"schema_version":"agentshare.meteora.pool_detail.v1.compact","top_level":{"p":"pool_address","v":"verdict","r":"risk_score","f":"flags"}}},"mcp_notes":"MCP tools return block 1 = one-line summary (read first); block 2 = JSON envelope. Pass compact=true on DeFi tools or add ?format=compact on REST. Prefer limit 3–5."}}}