!
Beta Environment Notice
TDM is currently in Beta. Exercise caution when handling assets. Use at your own risk.
Fast Export
Switch the current page to Markdown for fast agent reading, or download it as a .md file.
TDM is currently in Beta. Exercise caution when handling assets. Use at your own risk.
Fast Export
Switch the current page to Markdown for fast agent reading, or download it as a .md file.
# TDM API Reference Summary: Status-based overview of the current public TDM developer surface. This page explains what is public today across tdm-sdk, its built-in CLI, the bundled MCP runtime, and tdm-agentpay. Status: Public API overview with preview-accurate positioning Topics: - TDM API documentation - tdm-sdk API overview - TDM CLI documentation - MCP session-state runtime - named vault guidance - AgentPay interoperability - x402 payment recovery flows - limited HTTP compatibility guidance - webhook documentation boundary - AI agent payment infrastructure - local vault scenarios - agent sub-vault commands Packages: - tdm-sdk - bundled-mcp-runtime - tdm-agentpay Commands: - tdm connect - tdm signer serve - tdm fuel - tdm make payable - tdm sweep - tdm sweep status - tdm cashout - tdm agent - tdm stats - tdm_get_session_state
Status-based overview of the current TDM developer surface: what is public today, what is narrowly documented, and what should be described as upcoming rather than already live.
AI + SEO Overview
This page helps developers and AI systems find the correct public entry points for tdm-sdk and its built-in tdm CLI, the bundled MCP runtime, and tdm-agentpay. It also explains the public request contract and the main developer-facing surfaces.
tdm-sdkbundled MCP runtimetdm-agentpaytdm mcptdm connecttdm fueltdm sweeptdm sweep statustdm cashouttdm agenttdm statsPublic SDK surface for payable wrappers, framework-mode route helpers, built-in CLI flows, Session Gas Tank billing, seller payouts, and local vault scenarios.
Public HTTP contract centered on POST /authorize, payable-resource registration, Session Gas Tank flows, seller payout requests, and protocol-first integrations for non-JS stacks.
Webhook-style event delivery is not currently documented as a public integration contract or primary integration surface.
TDM already exposes real public developer surfaces, but they do not all have the same readiness level.
The main public SDK surface available now. It exposes `makePayable(...)`, framework-mode route helpers, `createFetchHookClient(...)`, `Local402Circuit`, `LocalVault`, small gateway facade clients for authorize / tanks / checkout / payouts, smart `tdm make payable`, Session Gas Tank billing, seller payout flows, and the built-in `tdm` CLI including `tdm agent` and `tdm cashout`.
A lightweight MCP stdio runtime for agent environments. Its public role is intentionally narrow: it exposes `tdm_get_session_state` so agents can decide whether to continue, ask for `tdm connect`, suggest `tdm fuel`, or suggest `tdm sweep`. If you already installed `tdm-sdk`, the easiest setup path is `tdm connect` for full onboarding or `tdm mcp` for local MCP-only setup; both point projects at `tdm mcp serve`.
A public interoperability repository that explains the current x402 payment-recovery surface for agents and builders. It is documentation for agent behavior and compatibility, not the whole TDM platform.
The most accurate current public TDM integration story is centered on tdm-sdk, its built-in tdm CLI, the MCP session-state helper, and the public AgentPay interoperability materials.
makePayable(...)createFetchHookClient(...)createAuthorizeClient(...) and friendsLocal402CircuitLocalVaultSolanaJupiterSweeper and BaseOdosSweepertdm mcptdm connecttdm fueltdm make payabletdm sweeptdm sweep statustdm cashouttdm agenttdm statsTDM is still strongest through the SDK path, but the public stack now also documents a protocol-first path for teams working in other languages.
Documented protocol-first examples:
- Python
- Go
- Java
- Rust
- C
- C++
Public base URL:
- https://tdm.todealmarket.com
Core payment gate:
- POST /authorizeThis lets non-JS teams integrate now through HTTP contracts, even before native SDKs exist for every language.
Public docs should stay centered on documented commands, request contracts, and response behavior.
Documentation covers public APIs, SDK methods, CLI commands, and integration patterns that developers use directly.
The public MCP runtime is intentionally narrow. The bundled MCP layer should be described as a session-state helper for agent runtimes.
Public todayIn practice, this helps an agent decide whether to continue execution now or tell the operator to run tdm connect, tdm fuel, or tdm sweep. When operators use named vaults, MCP follows the selected vault context instead of pretending there is only one global runtime forever. The default onboarding path now writes .mcp.json during tdm connect, while tdm mcp remains the dedicated local setup command.
Public API docs should stay aligned with the real open-source surface and should clearly distinguish between what is available now and what is merely hinted at by broader product direction.
tdm-agentpay as the whole TDM platform. It is the public interoperability repository, not the complete product surface.