Lucas docs

Lucas sells research to AI agents, paid per request over x402 in USDC on Base. There is no account and no API key: your agent sends a request, pays the price in the 402 response, and gets JSON back. Every claim comes with a source, and anything that cannot be confirmed is marked unverified.

Base URL: https://api.lucasnode.app

Quickstart

Any x402 client works. This example uses the official x402 packages for JavaScript. Ready-to-run scripts for the research endpoints are on GitHub. Your buyer wallet needs USDC on Base; it does not need ETH, because the payment processor covers network fees.

// npm install @x402/fetch @x402/evm viem
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// Your buyer wallet. It needs USDC on Base; no ETH is needed for fees.
const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);

const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await fetchWithPayment("https://api.lucasnode.app/api/x402/research", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    question: "Which payment processors does Shopify Plus support natively in the US?",
  }),
});

console.log(res.status, await res.json());

# curl cannot pay, but it shows the price and payment details Lucas asks for:
curl -i -X POST https://api.lucasnode.app/api/x402/research \
  -H "Content-Type: application/json" \
  -d '{"question":"Which payment processors does Shopify Plus support natively in the US?"}'

# Response: HTTP/2 402, with a PAYMENT-REQUIRED header holding base64-encoded JSON:
# network eip155:8453 (Base), asset USDC, amount 250000 ($0.25), payTo, and the
# Bazaar discovery schema describing this endpoint.

# Save the code above as buy.mjs, then run it with your own wallet key:
EVM_PRIVATE_KEY=YOUR_WALLET_PRIVATE_KEY node buy.mjs

Fact check

POST https://api.lucasnode.app/api/x402/fact-check · $0.05 per request. Send one claim or yes/no question and get a verdict with its source in a few seconds. It uses one web search, so it suits simple, checkable facts; for anything broader, use quick research.

Request body

{
  "claim": "Supabase's Pro plan starts at $25 per month."
}

Response

Quick research

POST https://api.lucasnode.app/api/x402/research · $0.25 per request. Ask any question and get a concise, sourced answer.

Request body

{
  "question": "Which payment processors does Shopify Plus support natively in the US?",
  "context": "Optional background to focus the research"
}

Response

{
  "question": "Which payment processors does Shopify Plus support natively in the US?",
  "answer": "Shopify Payments is Shopify's native payment gateway and processor ...",
  "key_points": [
    {
      "point": "Shopify Payments is the native payment processor for Shopify and Shopify Plus",
      "source": "https://eastsideco.com/blog/shopify-payments-guide"
    }
  ],
  "sources": [
    { "title": "Ultimate Guide To The Best Shopify Payments Gateways & Providers", "url": "https://eastsideco.com/blog/shopify-payments-guide" }
  ],
  "confidence": "medium",
  "unverified": ["Whether Shopify Plus has additional native payment processor support ..."],
  "disclaimer": "Quick research from public web sources. Verify important facts before relying on them."
}

Data analysis

POST https://api.lucasnode.app/api/x402/analyze · $0.20 per request. Send a table and a question. Lucas writes Python, runs it in an isolated sandbox (no internet, nothing else on it), and returns the answer together with the exact code that produced it, so every number can be re-checked. Typically about 10 seconds.

Request body

{
  "question": "Which month had the biggest total revenue growth versus the month before, and by what percent?",
  "data": "month,region,revenue\n2026-01,East,\"$14,200\"\n2026-01,West,\"$11,050\"\n2026-02,East,\"$15,900\"\n..."
}

Response

{
  "question": "Which month had the biggest total revenue growth versus the month before, and by what percent?",
  "answer": "March 2026 had the biggest total revenue growth versus the month before, up 16.49 percent.",
  "result": {
    "value": { "month": "2026-03", "growth_pct": 16.49 },
    "table": [
      { "month": "2026-02", "revenue": 28380, "growth_pct": 12.4 },
      { "month": "2026-03", "revenue": 33060, "growth_pct": 16.49 }
    ]
  },
  "code": "df['revenue'] = pd.to_numeric(df['revenue'].str.replace('[$,]', '', regex=True))\n...",
  "assumptions": ["Summed revenue across regions for each month."],
  "confidence": "high",
  "data": { "rows": 8, "columns": ["month", "region", "orders", "revenue"] },
  "computed_at": "2026-10-15T18:00:00.000Z",
  "disclaimer": "Computed by running the code above on the data you sent, in an isolated sandbox. Re-run the code to verify."
}

Your data is used only for this request. It runs in a sandbox that is deleted afterwards. Lucas keeps only your question and a short preview of the data (the first 500 characters) in its request log, never the full file.

Lead research

POST https://api.lucasnode.app/api/x402/leads · $1.00 per request. Describe the companies you want and get up to 3 matches, with every requirement checked.

Request body

{
  "description": "US-based B2B software companies that sell scheduling or practice-management tools to dental practices",
  "count": 2
}

Response

Companies with any requirement that is clearly not met are left out, so Lucas may return fewer than you asked for. Fewer, well-supported results are preferred over padding the list.

{
  "request": { "description": "US-based B2B software companies ...", "count": 2 },
  "requirements": ["US-based headquarters", "B2B software company", "..."],
  "companies": [
    {
      "name": "NexHealth",
      "website": "https://www.nexhealth.com",
      "summary": "A San Francisco-based patient experience platform ...",
      "checks": [
        {
          "requirement": "US-based headquarters",
          "status": "met",
          "evidence": "NexHealth was founded in 2017 and is based in San Francisco, California.",
          "source": "https://mppg.net/partners/operations/nexhealth/"
        }
      ],
      "confidence": "high"
    }
  ],
  "notes": "Both companies are privately held; no revenue threshold was specified ...",
  "disclaimer": "Company-level research from public web sources. Figures such as revenue are estimates; verify before relying on them."
}

Payments

Lucas uses x402. Send a request without payment and you get HTTP 402 with the payment details. Your x402 client pays and retries the same request with the payment attached.

All endpoints are listed in the Coinbase x402 Bazaar, so agents can discover them by search.

Errors

Errors return JSON in the form { "error": "..." }. Payment settles only after a successful response, so failed and rejected requests are never charged.

Limits

• Timing. A fact check typically takes a few seconds. Data analysis typically takes about 10 seconds. Quick research typically takes about 11 seconds. Lead research typically takes 20 to 50 seconds; allow up to 2 minutes.
• Sources. Research uses public web sources only.
• Company-level only. No personal contact details or private information about individuals. Requests for them are rejected.
• Estimates. Figures such as private company revenue are third-party estimates.
• Live signals. Things like current ad activity are marked unverified unless recent, dated evidence exists.
• AI-generated. Results are produced by an AI researcher. Verify important facts before relying on them.

For AI agents

These docs are also available as plain text, for agents to read directly:

• https://lucasnode.app/llms.txt: a short index with every endpoint.
• https://lucasnode.app/llms-full.txt: these docs in full, as one file.

Every 402 response also includes a Bazaar discovery section with an example request and a schema of the allowed fields.

Contact

Questions, problems with a request, or a listing or partnership inquiry: email hello@lucasnode.app.