url2md
URL → clean Markdown for AI agents. Static pages, JavaScript-rendered pages and PDFs. Honours robots.txt. Pays x402 tolls on your behalf. $0.005 per call in USDC on Base over x402.
InferenceLiveeip155:8453Exactvia cdp
MarkdownUrl-to-markdownScrapingPdfLlm-context
Calls · 30d
44↓ 47%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 18 snapshots so far.
$2.41
Verified settled volume
470 settlements proven x402 by their on-chain EIP-3009 marker.
$0.0050
Listed price
As published in the catalog. Always read the live 402 before paying.
44
Calls · 30d
Upstream's own call count for this endpoint, not ours.
4
Unique payers · 30d
Last called 2026-09-22 23:16Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0xa09aE66Ec8664475697FfC0eb45aa3Fe52Aa6030The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Provider
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"asset": "USDC",
"payTo": "0xa09aE66Ec8664475697FfC0eb45aa3Fe52Aa6030",
"price": "$0.005",
"scheme": "exact",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xa09aE66Ec8664475697FfC0eb45aa3Fe52Aa6030",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 120
}
],
"network": "eip155:8453",
"howToPay": "Sign an EIP-3009 USDC transfer authorization for accepts[0].amount to accepts[0].payTo (PAYMENT-REQUIRED header, base64 JSON) and retry with it in the PAYMENT-SIGNATURE header. The payer wallet needs USDC only, no ETH: the facilitator submits the transfer and pays the gas. Header names are case-insensitive. Client libraries: @x402/fetch and @x402/axios (JavaScript, https://www.npmjs.com/package/@x402/fetch) and x402 (Python, https://pypi.org/project/x402/). EIP-3009: https://eips.ethereum.org/EIPS/eip-3009.",
"x402Version": 2,
"amountAtomic": "5000",
"assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
0.005USDC≈ $0.005 USD
on Base · exact scheme
Pay 0.005 USDC on Base to 0xa09a…a6030. The signed payment is good for 2 minutes.
- Paid to
- 0xa09a…a6030
- USD Coin contract
- 0x8335…02913
- Payment window
- 2 minutes
- As published
- 5000 smallest units
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xa09aE66Ec8664475697FfC0eb45aa3Fe52Aa6030",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 120
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"body": {
"url": "https://example.com",
"format": "json",
"render": "auto"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"url": "https://example.com",
"lang": null,
"title": "Example Domain",
"words": 24,
"render": {
"mode": "auto",
"reasons": [],
"escalated": false
},
"source": "static",
"timing": {
"fetchMs": 268,
"totalMs": 412,
"renderMs": null,
"convertMs": 3,
"browserMsUsed": null
},
"charset": "utf-8",
"finalUrl": "https://example.com/",
"markdown": "# Example Domain\n\nThis domain is for use in documentation examples without needing permission. Avoid use in operations.\n\n[Learn more](https://iana.org/domains/example)",
"warnings": [],
"canonical": null,
"fetchedAt": "2026-09-06T03:45:14.033Z",
"redirects": [],
"contentType": "text/html",
"description": null,
"contentSignal": null,
"tokensEstimate": 42
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Absolute http(s) URL to convert; percent-encode it in the query string. http and https only, no credentials in the URL, no private, loopback or internal hosts, and the port must be one Cloudflare proxies (80, 443, 8080, 8443, 8880, 2052/2053/2082/2083/2086/2087/2095/2096). robots.txt is honoured for the user-agent token url2md."
},
"format": {
"enum": [
"json",
"markdown"
],
"type": "string",
"description": "json: the whole result object. markdown: the markdown body alone, sent as text/markdown. Omit it and the format follows the Accept header (text/markdown → markdown), else json."
},
"render": {
"enum": [
"auto",
"static",
"browser"
],
"type": "string",
"default": "auto",
"description": "auto: static first, browser only when the page looks client-rendered. static: never use a browser. browser: always render in a headless browser."
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"url",
"finalUrl",
"source",
"markdown",
"words",
"tokensEstimate",
"fetchedAt",
"timing",
"render",
"warnings"
],
"properties": {
"url": {
"type": "string",
"description": "the URL as asked for"
},
"lang": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
],
"description": "also sent percent-encoded as X-Url2md-Title"
},
"words": {
"type": "integer",
"description": "also sent as X-Url2md-Words"
},
"render": {
"type": "object",
"properties": {
"mode": {
"enum": [
"auto",
"static",
"browser"
],
"type": "string"
},
"reasons": {
"type": "array",
"items": {
"type": "string"
}
},
"escalated": {
"type": "boolean"
}
}
},
"source": {
"enum": [
"static",
"browser",
"pdf",
"origin-markdown",
"text"
],
"type": "string",
"description": "how the markdown was produced; also sent as X-Url2md-Source"
},
"timing": {
"type": "object",
"properties": {
"fetchMs": {
"type": "integer"
},
"totalMs": {
"type": "integer"
},
"renderMs": {
"type": [
"integer",
"null"
]
},
"convertMs": {
"type": "integer"
},
"browserMsUsed": {
"type": [
"integer",
"null"
]
}
}
},
"charset": {
"type": [
"string",
"null"
]
},
"finalUrl": {
"type": "string",
"description": "the URL after redirects; also sent as X-Url2md-Final-Url"
},
"markdown": {
"type": "string",
"description": "the converted page"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": "string",
"format": "date-time"
},
"redirects": {
"type": "array",
"items": {
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"status": {
"type": "integer"
}
}
}
},
"contentType": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"contentSignal": {
"type": [
"string",
"null"
],
"description": "Upstream Content-Signal header, passed through untouched"
},
"blockSuspected": {
"type": [
"object",
"null"
],
"properties": {
"markers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "set when what came back looks like a bot challenge or block page rather than the page: the origin answered 200 and the call was charged, but the content is probably not what was asked for. Also sent as X-Url2md-Block-Suspected, and named in warnings[]."
},
"tokensEstimate": {
"type": "integer",
"description": "also sent as X-Url2md-Tokens-Estimate"
}
},
"description": "The conversion result. The same metadata always travels in response headers as well, so a caller that asked for text/markdown still gets it: X-Url2md-Source (static | browser | pdf | origin-markdown | text), X-Url2md-Final-Url, X-Url2md-Title (percent-encoded), X-Url2md-Words, X-Url2md-Tokens-Estimate, X-Url2md-Ledger-Id (the ledger row for the settled payment), and X-Url2md-Upstream-Toll (USD paid to the origin when the page itself charged an x402 toll, absent otherwise). The x402 settlement receipt is in PAYMENT-RESPONSE. Errors are JSON with a stable error.code, and any error after a charge carries error.details.callerCharged with the ledger id."
}
}
}
}
}
}
}Provenance
- Seen in the source catalog
- 2026-09-22 23:16Z
- Last indexed by Roundhouse
- 2026-09-24 09:20Z
- Last enriched (probe, favicon, geo)
- 2026-09-20 14:15Z
- x402 version
- 2
- Max timeout
- 120s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 18 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service url2md and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=url2md' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://url2md.io/v1/md, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402, or use an organization key from https://roundhouseai.io/dashboard/team. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.