!
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 HTTP Contract Summary: Conservative public guide to the current TDM HTTP layer. The live contract today is centered on POST /authorize, resource registration, optional Session Gas Tank flows, seller payout requests, and MCP-assisted operator guidance. Status: Public HTTP contract Topics: - POST /authorize - protocol-first integrations - Session Gas Tank - seller payout requests - MCP runtime guidance Packages: - tdm-sdk - bundled-mcp-runtime - tdm-agentpay Commands: - tdm connect - tdm make payable - tdm agent - tdm fuel - tdm sweep - tdm stats - tdm_get_session_state
The current public HTTP story is real, but intentionally narrow. Public integrations should center on https://tdm.todealmarket.com, the POST /authorize contract, and the surrounding resource/session flows.
POST /authorizePOST /discovery/payable-resourcesGET /discovery/payable-resourcesGET /api/v1/public/payable-resources/:resourceIdPOST /api/v1/checkout-sessionsGET /api/v1/checkout-status/:paymentIdPOST /api/v1/checkout-confirmGET /api/v1/bridge/listingsGET /api/v1/bridge/x402/resourcesGET /api/v1/bridge/mpp/servicesGET /api/v1/bridge/mpp/llms.txtGET /api/v1/bridge/buy/:resourceIdPOST /api/v1/bridge/purchaseGET /v1/deliver/:tokenPOST /v1/reportPOST /telemetryPOST /v1/tanks/create-subPOST /v1/sessions/delegatePOST /publisher/payoutsGET /publisher/payoutsGET /publisher/payout-walletsPOST /publisher/payout-walletsGET /usage/statsGET /analytics/overviewGET /analytics/exportPOST /authorize is the payment gate for a paid action. It is not a wallet-login endpoint. The caller describes the action, the resource or operation, and the requested price, and TDM decides whether to debit a normal account balance or a prepaid Session Gas Tank.
Session Gas Tank is an optional billing mode for selected agents. The agent or its root owner pre-funds balance once, then repeated microcharges reuse the same settlement path without requiring a fresh chain action each time.
During POST /authorize, TDM performs the revenue split: buyer debit, seller credit, and platform fee allocation. Sellers can then request payout through the public payout endpoints.
If a default wallet is already saved for the selected chain,destination_address becomes optional. Integrators can still pass a one-off destination when they intentionally want to override the saved wallet.
After a successful POST /authorize, a payable resource can return a short-lived delivery token and delivery URL. The simplest product framing is either Direct Pay, where you deliver yourself after payment, or an experimental Protected Unlock flow with redirect or inline delivery.
Public payable resources can also be exposed through bridge surfaces for external agent ecosystems. These endpoints advertise the resource and point buyers or agents back into the same TDM checkout and unlock flow instead of replacing settlement.
Buyers and operators can report spam, malware, fraud, or other unsafe resources through the public beta reporting surface.
Hosted TDM flows can emit anonymous usage and operational metrics for aggregate statistics, reliability, and reporting. JavaScript SDK and CLI flows handle this automatically when a live service is configured. Other integrations can optionally send the same neutral metrics if they want to appear in aggregate reporting.
Describe the current TDM HTTP layer as a real, narrow, protocol-first integration surface. Do not expand it into product claims that are broader than the published contract.