Suplementor logoSuplementor
x402 · USDC on Base

Supplement data API for AI agents.

Structured, normalized, and verified supplement data — pay per call with x402. No API keys, no contracts, no rate-limit negotiations. Discover the schema, send a request, settle a micro-payment, and get data back.

Read the OpenAPI specView discovery document

Endpoints & pricing

Pay-per-call pricing in USDC. Amounts are settled on Base.

GET$0.005
/api/v1/x402/products?q=

Full-text search across the verified product catalog.

GET$0.01
/api/v1/x402/products/:id

Fetch a product with its normalized ingredient list.

POST$0.01
/api/v1/x402/submissions

Submit a new product, earn 100 read credits (paid, replay-protected).

POST$0
/api/v1/x402/usage

Get wallet-scoped usage, submissions, and outstanding credits (signed).

How it works

  1. 1

    Discover

    Fetch /.well-known/x402.json, then /api/v1/openapi.json for full schema and route details.

  2. 2

    Call the endpoint

    Make the request as documented. No API key or signup is required to begin.

  3. 3

    Receive a 402 challenge

    An unpaid request returns HTTP 402 PAYMENT-REQUIRED with x402 payment requirements and Bazaar discovery metadata.

  4. 4

    Pay with USDC on Base

    Settle the micro-payment via the x402 protocol. Submissions are authenticated by the payment itself and protected against replay via the payment nonce.

  5. 5

    Get structured data

    On settlement the endpoint returns normalized JSON — ready to use in your agent pipeline.

Example flow
# 1. Unpaid request returns a 402 challenge
curl -i "https://suplementor.io/api/v1/x402/products?q=vitamin"
# => HTTP/1.1 402 PAYMENT-REQUIRED
#    { "accepts": [ ... x402 payment requirements ... ],
#      "extensions": { "bazaar": { ... } } }

# 2. Retry with an x402 payment header (USDC on Base)
curl "https://suplementor.io/api/v1/x402/products?q=vitamin" \
  -H "X-PAYMENT: <x402-payment-payload>"
# => 200 OK  { "data": [ { "id": 123, "name": "Vitamin C 1000" } ], ... }

Discovery surfaces

Everything an agent needs to find and call the API, machine-first.

/.well-known/x402.json

Machine-readable x402 discovery index. Start here.

/api/v1/x402/discovery

Same discovery index for direct API clients.

/api/v1/openapi.json

OpenAPI 3.1 document with x402 vendor extensions.

/llms.txt

Compact agent-facing summary and entry points.

Capabilities

  • Search the verified catalog by free-text query, with pagination.
  • Fetch a product and its normalized ingredient list by id.
  • Submit a new product with an x402 payment.
  • Inspect usage with signed wallet auth (searches, fetches, submissions, credits).

Build with verified supplement data.

Point your agent at the discovery document and start calling. Prefer a UI? Create an account to explore the catalog first.

Get the OpenAPI specCreate an account