Skip to main content
INTEGRATIONS

Plug Blockchain0x into your agent stack.

Real code for every popular agent framework. A shipped package where one exists, a short SDK recipe where it does not.

Pick your framework. Where we ship a package you install it; otherwise you wrap our SDK in that framework's native tool. Either way it is a thin layer over one HTTP API, and you can skip it and call the API directly.

Each card opens a deep-dive: the install or the recipe, a working agent example, webhook handling, and common pitfalls. Three ship as real packages today - blockchain0x-langchain and blockchain0x-crewai on PyPI, and @blockchain0x/mcp on npm. The other seven are short recipes over the same SDK. No invented package.

WHAT EVERY INTEGRATION INCLUDES

A consistent shape across every framework.

  • The install command for the package, or the recipe when there is no package
  • Copy-paste code you can run, not pseudocode
  • A short answer to 'how do I add payments to my {framework} agent'
  • FAQ entries with HowTo/FAQ schema for AI search engines
  • A link to the matching long-tail landing page
  • A link to the pricing page
ARCHITECTURE

Every integration is a thin wrapper over the same API.

The Blockchain0x integrations are not 10 separate products. They are 10 different ergonomic surfaces on top of a single HTTP API. The API is the source of truth; the framework wrappers exist to save you time.

SDK architecture diagram: framework wrappers calling a single Blockchain0x HTTP API

Each wrapper translates from "the way your framework defines a tool" into "an HTTP call to our API". That is the entire job. The Python adapters expose create_blockchain0x_toolset(client), which hands LangChain or CrewAI a ready-made set of tools. A framework without a shipped adapter wraps createX402Client(...) (Node) or the blockchain0x client (Python) in a native tool of that framework. Same API underneath, either way.

This matters for a few reasons. First, you can mix and match: a LangChain production agent and a CrewAI experimental agent can both target the same Blockchain0x agent wallet without conflict. Second, you are not locked into a framework choice through us; switching frameworks does not require any change to your wallet, your spend policies, or your public page. Third, when we ship a new endpoint or a new webhook event, the framework wrappers expose it on their next release; the underlying API is the contract.

SKIP THE SDK

You can integrate without our SDK, our wrapper, or our framework integration.

The Blockchain0x API is plain JSON over HTTPS with bearer-token auth. Any HTTP client in any language can call it. The official SDKs and framework wrappers are convenience layers; the raw API is documented, stable, and intentionally small enough that hand-writing against it is reasonable.

CURL - NO SDK
curl -X POST https://api.blockchain0x.com/v1/payments \
  -H "Authorization: Bearer $BLOCKCHAIN0X_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId":   "<your-agent-id>",
    "to":        "0xRecipientAddress",
    "amountWei": "100000",
    "metadata":  { "reason": "Custom market analysis" }
  }'

When skipping the SDK makes sense

  • You are in a language we do not ship. Go, Rust, Elixir, Ruby, PHP, Java - all of these can call our API natively with their standard HTTP libraries. No special tooling required.
  • You are on the edge. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - environments where you would rather not bundle an extra dependency. The raw API works there without changes.
  • You want to see exactly what is on the wire. For debugging, security review, or learning the protocol, the raw HTTP shape is clearer than reading SDK source.
  • You have your own HTTP layer with retries, logging, telemetry. Bringing in another SDK with its own retry behavior fights your existing infrastructure. Calling the raw API as just another HTTP endpoint slots in cleanly.

The full API reference at docs.blockchain0x.com includes the OpenAPI spec, so you can also generate your own client in any language that has an OpenAPI codegen tool.

PICKING A FRAMEWORK

When each framework is the right tool.

If you have not picked an agent framework yet, here is how we see the trade-offs. None of these are wrong choices; the right one depends on what your agent does and who maintains it.

FrameworkBest whenAvoid when
LangChainExisting LangChain codebase, complex tool chains, broad ecosystem useYou want minimal dependencies; LangChain pulls in a lot
LangGraphStateful multi-step workflows, durable execution, human-in-the-loopSimple linear chains; the graph overhead is wasted
CrewAIMulti-agent collaboration patterns (researcher + writer + reviewer)Single-agent loops; CrewAI is built for crews
AutoGenMulti-agent conversation, group chat patterns, Microsoft toolingProduction high-throughput; AutoGen optimizes for research
LlamaIndexRAG-heavy agents, document Q+A as core capabilityPure tool-use agents; LlamaIndex's strengths go unused
OpenAI Agents SDKOpenAI-only stacks, want the cleanest tool-use APIMulti-provider stacks; OpenAI SDK is OpenAI-centric
Pydantic AIStrong typing across all agent inputs/outputs, Python-firstTypeScript-first stacks; the Python-native typing is the value
Semantic KernelExisting .NET / C# / Java codebase, enterprise Microsoft shopPython-only teams; you are paying for unused MS integration
AgnoPython-native, lightweight, want minimal abstraction overheadYou need the LangChain ecosystem's third-party integrations
MCP middlewareYou are running an MCP server and want clients to pay per callYou are not running an MCP server (it is a server-side pattern)

Two practical pieces of advice. If you are starting from scratch and want the smallest possible learning curve, LangChain or OpenAI Agents SDK are the safest defaults. If you already have a framework, our integration for it works fine; do not switch frameworks just to use Blockchain0x.

DEEPER GUIDES

Specific scenarios get their own page.

Beyond the framework-specific integration pages, we publish long-tail guides on narrower questions: "how do I add payments to a LangGraph multi-step workflow", "how do I let my MCP server charge per tool", "how do I gate a Stripe-like API behind USDC payment". These live at /lp/{slug} and are intentionally not in the main navigation. They get found through search; each links back to the relevant integration page.

Where to find them

The first batch of long-tail guides ships alongside the integration framework pages. Until then, the most concrete scenario-specific content lives in the docs at docs.blockchain0x.com under "Guides". Each /lp/ page includes working code you can run and a direct CTA to upgrade the relevant agent to Pro.

FREQUENTLY ASKED

Five integration questions worth answering.

If the SDK is optional, why does it exist at all?

Three reasons. First, ergonomics: the SDK auto-generates idempotency keys, types every request and response, and bundles webhook signature verification so you do not write that code yourself. Second, drift protection: when we add an endpoint or change a field, the next SDK release exposes it; raw HTTP users need to read the changelog. Third, instrumentation: the SDK auto-emits structured logs and metrics in a format compatible with common observability stacks. None of these are essential, but they save 30-90 minutes of integration time. If you would rather see the raw shape of the API, skip the SDK and use curl or any HTTP client.

I am using a framework you do not list. Can I still integrate?

Yes. Every integration sits on the same small REST API: agents, payments, payment-requests, transactions, webhooks, plus read-only spend permissions. Auth is a bearer token, webhooks are signed with HMAC-SHA256. If you can speak HTTP, you can integrate from any framework, including ones with no shipped wrapper - you just wrap our SDK in that framework's own tool. The framework pages exist for convenience, not gatekeeping. Want an official adapter for your framework? Tell us through the docs and we will weigh it against demand.

Can one agent be served by multiple framework integrations at once?

Yes. A single agent has one wallet address, one set of API keys, one spend policy, and one public page. Different parts of your stack can call our API through different framework integrations: a LangChain agent in production, a CrewAI experiment, an MCP server middleware, all paying the same agent or all charging through the same agent. The framework boundary is on your side; we just see authenticated API requests and webhook subscriptions.

Do the framework integrations cost extra?

No. The shipped adapters - blockchain0x-langchain and blockchain0x-crewai on PyPI, and the @blockchain0x/mcp server on npm - are free, and so are the SDKs. For every other framework there is no extra package to buy: you wrap the SDK yourself in a few lines. Your cost is the per-agent subscription plus transaction fees you would pay either way. Installing the LangChain package costs the same as calling the API with curl. The package saves time, it does not gate features.

How quickly do you update integrations when frameworks ship breaking changes?

For the shipped adapters (blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp) we track the frameworks people actually use and update when a major version lands; we are early and do not promise a fixed SLA yet. Minor versions usually need no change because the adapters wrap stable interfaces. The recipe-based frameworks barely move here: they call the SDK directly, so a framework bump rarely touches our surface. If a breaking change makes an adapter unsafe, we note it on the matching /integrations/ page before pulling support.

Plug it in, start getting paid.

Free to start. Five minutes to your first payment request.