datapoint.market documentation

datapoint.market turns any API endpoint or MCP server into a paid, agent-callable x402 URL. Providers publish for free; an immutable on-chain splitter atomically pays the provider their price and datapoint.market a fee on top — non-custodially, on Base, Stellar, and Solana. Buyers (humans or AI agents) pay per call with USDC; no account needed.

These docs are written for AI agents (Claude and others) and the developers who run them. They’re organized so you can jump to what you need:

Start here

• Overview — what datapoint.market is, the mental model, and the two roles (buyer vs provider).
• Quickstart — the fastest path: buy a call, or publish an endpoint.

Concepts (understand the system)

• Concepts — x402, relays vs MCP wrappers, data samples & free trials, buying custody & budgets, splitters & fees, networks, auth.

Guides (do a task)

Start here as an agent

• Use it as an agent — every task mapped to connector vs raw HTTP, plus the buy options at a glance.

Buy

• Buying with the connector — discover + buy through Claude (fund a wallet, call_endpoint(confirmed=true)).
• Wallet & budgets — top up, read balances, cap spend with buy jobs/policy, recover funds.
• Buy: raw x402 flow — the accountless per-chain flow (sign your own X-PAYMENT).

Sell

• Connect in Claude — provider login via the MCP OAuth flow.
• Publish an endpoint — API relay or MCP wrapper, with the buyer-facing sample.
• Sell a dataset — list a downloadable file (pay → download link).
• Manage endpoints — edit, pause/resume, delete; rotate origin auth.
• Getting paid — how payouts work: pay_to, the splitter, per-call settlement.

Examples

• Crypto-native listings — a first batch (DEX price, gas, wallet analytics, tx-verify) end-to-end, using freshness_critical.

Reference (look up details)

• Management MCP tools — the full tool catalog + auth.
• REST API — endpoints, request/response shapes.
• Networks & assets — Base + Stellar + Solana, USDC, decimals, fees.

The 30-second version for an agent

1. To buy: check the free sample first — GET /e/{provider}/{endpoint}/schema.json (or read it from the 402 body) gives the response JSON Schema + a synthetic example, so you can decide before paying. If the endpoint offers a free trial, an unpaid call returns real data (look for freeTrial in the 402 body and the X-Datapoint-Trial-Remaining header). To pay: GET/POST the relay URL → HTTP 402 with the price → sign an X-PAYMENT header → resend → result + on-chain receipt. No signup. Or, if you’re connected via the connector: search_marketplace → get_endpoint_sample → create_wallet (fund it) → call_endpoint(confirmed=true) — it pays from a managed wallet for you (no buy job needed) (guide).
2. To sell: authenticate with a verified-email account (connect in Claude via OAuth, or magic-link → automation key; the connector is email-gated, so a wallet-only account must add an email first) → call the management MCP at POST /mcp (or the REST API) to create_api_relay / create_mcp_wrapper / create_dataset, then publish_endpoint. Buyers get a free synthetic sample of your response automatically; optionally offer metered free trials of real data (trial_safe + free_trial_calls).

Base URLs: API https://api.datapoint.market · site https://datapoint.market. A self-describing index lives at GET / and a machine-readable marketplace at GET /discover.json.