# info.description
Tradehand's public, read-only API for agent discovery and website content. Stable endpoints use /api/v1. Breaking changes receive a new major URL version. Deprecated versions remain available for at least 180 days and are announced with Deprecation, Sunset, and successor-version Link headers.

# paths./api/v1/status.get.description
Confirms the current public API version and returns canonical discovery, OpenAPI, and MCP links.

# paths./api/v1/status.get.responses.429.description
The client exceeded the public API request quota.

# paths./api/v1/pages/markdown.get.summary
Read a public Tradehand page as markdown

# paths./api/v1/pages/markdown.get.description
Server-renders a public Tradehand website page and returns its main content as text/markdown.

# paths./api/v1/pages/markdown.get.parameters[].description
Same-origin public website path, such as /pricing.

# paths./api/v1/pages/markdown.get.responses.200.description
Markdown rendering of the requested public page.

# paths./api/v1/pages/markdown.get.responses.400.description
The supplied path is missing or unsupported.

# paths./api/v1/pages/markdown.get.responses.404.description
The requested page does not exist; canonical content negotiation returns recovery markdown.

# paths./api/v1/pages/markdown.get.responses.429.description
The client exceeded the public API request quota.

# paths./api/v1/pages/markdown.get.responses.502.description
The source page could not be fetched or converted.

# paths./api/mcp.post.description
Sends one JSON-RPC 2.0 message to the stateless MCP Streamable HTTP transport using protocol version 2025-06-18.

# paths./api/mcp.post.parameters[].description
Protocol version for requests after initialization.

# paths./api/mcp.post.responses.200.description
A JSON-RPC response to a JSON-RPC request.

# paths./api/mcp.post.responses.202.description
A JSON-RPC notification was accepted; the response has no body.

# paths./api/mcp.post.responses.400.description
The JSON-RPC body or MCP protocol version is invalid.

# paths./api/mcp.post.responses.403.description
A browser supplied a cross-origin Origin header.

# paths./api/mcp.post.responses.406.description
The client did not advertise both MCP response media types.

# components.headers.RateLimit.description
Current available quota and effective window using the IETF structured field draft.

# components.headers.RateLimitPolicy.description
Named quota, unit allocation, and window using the IETF structured field draft.

# components.headers.RateLimitRemaining.description
Requests remaining in the current window.

# components.headers.RateLimitReset.description
Seconds until the current window resets.

# components.headers.RetryAfter.description
Seconds to wait before retrying a rate-limited request.

# components.schemas.Problem.description
RFC 9457 problem details with agent recovery extensions.

# x-versioning.legacyCompatibility
/api/markdown is deprecated in favour of /api/v1/pages/markdown.