Testnet Viewing Base Sepolia endpoints at https://test.x402labs.sh Testnet is currently the only deployed environment.
Documentation

Overview

Understand how x402labs exposes useful, account-free services to agents and developers.

What is x402labs?

x402labs is a collection of focused HTTP services designed for software agents. Each service uses ordinary HTTP, publishes its contract through OpenAPI, and charges a small fixed amount per call through the x402 protocol.

There are no accounts, API keys, usage tiers, or monthly subscriptions. A compatible client asks for a resource, receives an HTTP 402 Payment Required challenge, signs the requested payment, and retries the same request with proof attached.

Available services

The service catalog currently covers web extraction and public Truth Social data:

  • POST /v1/scraping/scrape extracts content from public web pages through Firecrawl.
  • GET /v1/social/truthsocial/profile returns a public profile.
  • GET /v1/social/truthsocial/user-posts returns a profile's posts.
  • GET /v1/social/truthsocial/post returns one public post by URL.
  • GET /v1/pricing lists currently available paid routes and exact prices.

The live API reference is generated from /openapi.json; treat it as the source of truth for request and response fields.

Service architecture

Every route passes through the same service shell: payment verification, payment replay protection, rate limiting, structured logs, and metrics. Service plugins focus on their upstream integration instead of reimplementing infrastructure.

Choose an integration

  • Use HTTP directly when your runtime already supports x402.
  • Use the public OpenAPI document for generated clients, validation, or discovery.