Alchemy

Alchemy website API

Public HTTP surface of www.alchemy.com, plus the rules for reading the site as markdown instead of HTML. Reading the site as markdown Every page under /blog/,…

Finance & banking#cryptocurrency

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Public HTTP surface of www.alchemy.com, plus the rules for reading the site as markdown instead of HTML.

Reading the site as markdown

Every page under /blog/, /overviews/, /case-studies/, /terms-conditions/, /rpc/ has a markdown twin, and so does the homepage. Reach it either way:

  • Append .md to the path — /blog/some-post.md. One request, 200, text/markdown.
  • Send Accept: text/markdown to the HTML URL. The response is a 307 to the .md URL and carries Vary: Accept.

Curated indexes for crawling the whole site live at /llms.txt (grouped, one line per page) and /llms-full.txt (every page body in one file). Per-section indexes are at / /llms.txt.

Errors

Endpoints under /api/ answer with JSON on failure. Paths that match nothing return 404 with an Error body: a stable code to branch on, a human message, and a hint naming the next step. Older faucet endpoints additionally carry the legacy error and statusCode fields described on each operation; both shapes are stable.

Rate limits

The faucet endpoints are CAPTCHA-gated and rate limited per address and per network. Everything else described here is a read, most of it prerendered and served from the CDN, with no documented per-caller limit; cache it rather than re-fetching.

Endpoints 15

Faucets

  • POSTRequest testnet funds/api/faucets/:faucetId/sendSends the network's drip amount to address. Requires a Cloudflare Turnstile token obtained from the faucet page for that network…
  • GETCheck a faucet transaction/api/faucets/:faucetId/status?transactionHash=stringChecks a transaction returned by sendFaucetFunds. Unconfirmed transfers report status: "pending". For Solana, the signature must belong to a stored faucet…

Site

  • GETSite search index/api/search/:localeThe full command-palette index for a locale: blog posts, guides, case studies and dapp listings, each with a title, description and URL. Prebuilt at deploy…
  • GETEcho the caller's IP/api/ipReturns the IP address the CDN saw for this request. null when the edge did not supply one.
  • GETThis document/openapi.jsonThe OpenAPI description of this API. Also served at /api/openapi.json.
  • GETAny /api path that does not exist/api/:unmatchedPathNot an endpoint. Listed so the failure shape is discoverable: every request under /api/ that matches no operation above answers 404 with an Error body rather…

Content

  • GETHomepage as markdown/index.mdThe homepage rendered as markdown: what Alchemy is, the products and chains it supports, and who builds on it. Equivalent to requesting / with Accept:…
  • GETA /blog/ page as markdown/blog/:slug.mdThe markdown twin of a page under /blog/: YAML frontmatter with title and description, then an H1 and the body. Equivalent to requesting /blog/{slug} with…
  • GETA /overviews/ page as markdown/overviews/:slug.mdThe markdown twin of a page under /overviews/: YAML frontmatter with title and description, then an H1 and the body. Equivalent to requesting…
  • GETA /case-studies/ page as markdown/case-studies/:slug.mdThe markdown twin of a page under /case-studies/: YAML frontmatter with title and description, then an H1 and the body. Equivalent to requesting…
  • GETA /terms-conditions/ page as markdown/terms-conditions/:slug.mdThe markdown twin of a page under /terms-conditions/: YAML frontmatter with title and description, then an H1 and the body. Equivalent to requesting…
  • GETA /rpc/ page as markdown/rpc/:slug.mdThe markdown twin of a page under /rpc/: YAML frontmatter with title and description, then an H1 and the body. Equivalent to requesting /rpc/{slug} with…
  • GETCurated site index/llms.txtEvery page on the site, grouped by section, one line each with a title, URL and one-sentence description. Long sections are split into /<section>/llms.txt…
  • GETWhole site in one file/llms-full.txtEvery page body concatenated into a single file. Large; prefer /llms.txt plus per-page .md fetches unless you genuinely want everything.
  • GETSitemap/sitemap.xmlEvery indexable URL, as a standard XML sitemap index.

API details

Base URL
https://www.alchemy.com
Authentication
None declared in the description
Operations
15 operations on 15 pathsGET 14POST 1
Main resources
Content 9Site 4Faucets 2
Response formats
text/markdown application/json text/plain application/xml
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the Alchemy website API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Alchemy website API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Request testnet funds” (POST /api/faucets/:faucetId/send), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Alchemy website API?

Public HTTP surface of www.alchemy.com, plus the rules for reading the site as markdown instead of HTML. Reading the site as markdown Every page under /blog/,… It is listed under Finance & banking and has 15 endpoints.

Who publishes the Alchemy website API?

It is listed from Alchemy's public API description (an OpenAPI document), not published by Alchemy on Swastik Codes. Anyone who controls alchemy.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Alchemy website API?

Requests go to https://www.alchemy.com. Endpoint paths are added to this base URL.

How do I authenticate with the Alchemy website API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Alchemy website API have?

15 operations on 15 paths (14 GET, 1 POST). The largest groups are Content, Site, Faucets.

Is forking the Alchemy website API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.