# API Acre

> 61 machine-discoverable, x402-paid JSON APIs for autonomous agents.

## Discovery and invocation

- Base URL: https://apiacre.com
- Catalog with schemas and exact, spend-capped purchase handoffs: /catalog (JSON compatibility alias: /catalog.json)
- Consolidated Markdown service reference with schemas and examples: /llms-full.txt
- x402 discovery: /.well-known/x402 (JSON compatibility alias: /.well-known/x402.json)
- OpenAPI 3.1: /openapi.json
- Agent crawler OpenAPI fallback: /agents.json
- Agent integration guide: /integrations
- Agent Skills instruction file: /SKILL.md
- Portable Codex plugin bundle: /plugins/api-acre.zip (hashes: /integrations.json)
- A2A 1.0 Agent Card: /.well-known/agent-card.json
- A2A HTTP+JSON discovery agent: /a2a/message:send (eight curated semantic discovery skills; no paid execution).
- MCP Streamable HTTP endpoint: /mcp (protocol 2025-06-18)
- MCP tool catalog: /mcp/tools
- MCP discovery card: /.well-known/mcp.json
- MCP server card: /.well-known/mcp/server-card.json
- MCP resources/list exposes the free workflow catalog; resources/read never purchases a tool.
- MCP resources/templates/list exposes free task-to-service recommendations; reading one never executes or pays.
- Human-readable API reference: /docs
- Buyer SDK quickstart: /buyers
- Public GitHub integration hub: https://github.com/APIAcre/apiacre
- Copyable multi-call recipes with exact total prices: /workflows.json
- Human-readable workflow guide: /workflows
- Per-workflow HTML and JSON recipes: /workflows/{workflow-id} and /workflows/{workflow-id}.json
- Code-metrics data-contract recipe: /workflows/code-metrics-contract
- Base address evidence recipe: /workflows/base-address-evidence
- Website, domain, and email-authentication evidence recipe: /workflows/website-domain-evidence
- Service documentation links every complete recipe that uses that API; each step remains separately authorized.
- Exact USDC prices and browser checkout links: /pricing
- Custom API, volume, or integration requests: /request-api (hello@apiacre.com)
- Free static result gallery: /samples
- Each /samples/<service-slug> response includes requestExample plus exact x402 purchase metadata, links, and spend-capped Coinbase Agentic Wallet and optional AgentCash commands on Base.
- Decision-oriented sample workflows: /use-cases
- Free Three.js arcade gallery: /arcade
- Free intent search (never executes or pays): /recommend?task=redact+personal+data&max_price=0.05
- Python buyer example: /examples/python-buyer.py
- TypeScript buyer example: /examples/typescript-buyer.ts
- Coinbase Agentic Wallet buyer example: /examples/awal-buyer.sh (official Coinbase client; running may pay automatically; exact atomic USDC cap).
- AgentCash buyer example: /examples/agentcash-buyer.sh (third-party client; fetch may pay automatically; exact spend cap).
- Payment: x402 v2 exact USDC on Base; no account or API key is required.
- Call a POST endpoint with JSON. On HTTP 402, satisfy PAYMENT-REQUIRED and retry with PAYMENT-SIGNATURE.
- Responses contain request_id, service, version, structured data, execution meta, and curated next_actions where a separate paid step is useful.
- Every next_action is optional and requires its own HTTP 402 challenge and explicit buyer authorization.
- Use Idempotency-Key when retrying the same paid request.

## Services

- [Web content extraction](/services/web.extract): POST /v1/web/extract ($0.01 USDC) — Extract clean readable text or Markdown plus bounded structured links, canonical and heading signals, Schema.org types, redirect evidence, content hashes, and response provenance for research, RAG, or agent context.
- [Metadata extraction](/services/web.metadata): POST /v1/web/metadata ($0.002 USDC) — Extract an agent-ready public-page metadata record with redirects, response provenance, canonical and alternate URLs, headings, icons, feeds, social cards, Schema.org types, and privacy-safe publisher-asserted Organization facts with field evidence.
- [SEO audit](/services/web.seo-audit): POST /v1/web/seo-audit ($0.05 USDC) — Audit on-page technical SEO, score a public URL, and return prioritized, actionable issues for search optimization.
- [Web security audit](/services/web.security-audit): POST /v1/web/security-audit ($0.05 USDC) — Scan a public website for TLS and browser security header weaknesses and return a security score with fixes.
- [Accessibility audit](/services/web.accessibility-audit): POST /v1/web/accessibility-audit ($0.05 USDC) — Check a public page for deterministic HTML accessibility problems and return actionable WCAG-oriented findings.
- [Performance profile](/services/web.performance-profile): POST /v1/web/performance-profile ($0.025 USDC) — Measure website response latency, payload size, compression, caching, and performance signals for a public URL.
- [Link and site-map analysis](/services/web.links): POST /v1/web/links ($0.005 USDC) — Extract and classify links from one public page or safely crawl up to 10 same-origin pages into an agent-ready site map with page provenance, depth limits, and robots.txt enforcement.
- [Robots and sitemap audit](/services/web.robots-sitemap): POST /v1/web/robots-sitemap ($0.025 USDC) — Inspect a domain's robots.txt crawl rules and XML sitemap health, availability, and URL count.
- [Technology fingerprint](/services/web.tech-fingerprint): POST /v1/web/tech-fingerprint ($0.025 USDC) — Identify frameworks, analytics, CDNs, servers, and other website technologies from public response signals.
- [Email authentication posture](/services/web.email-auth): POST /v1/web/email-auth ($0.005 USDC) — Check a public domain's email authentication and anti-spoofing posture using MX, SPF, DMARC, caller-selected DKIM, MTA-STS, TLS-RPT, and BIMI DNS evidence.
- [Domain intelligence](/services/web.domain-intelligence): POST /v1/web/domain-intelligence ($0.02 USDC) — Investigate a domain using parallel DNS, TLS certificate, RDAP, DNSSEC, SPF, and DMARC signals with factual findings and source provenance.
- [Full site audit](/services/web.full-audit): POST /v1/web/full-audit ($0.25 USDC) — Run a comprehensive website audit combining SEO, security, accessibility, and performance scores with prioritized fixes.
- [Business domain due diligence](/services/web.business-due-diligence): POST /v1/web/business-due-diligence ($0.1 USDC) — Assess a business domain using website quality, SEO, security, accessibility, performance, DNS, TLS, RDAP, and optional public GLEIF LEI entity candidates.
- [GLEIF legal entity search](/services/research.lei-entity-search): POST /v1/research/lei-entity-search ($0.01 USDC) — Search the official GLEIF Global LEI Index by exact LEI or legal name and return ranked legal-entity identity, registration, mapped-identifier, and relationship-availability evidence.
- [Document extraction](/services/document.extract): POST /v1/document/extract ($0.01 USDC) — Extract clean text and metadata from supplied PDF, DOCX, HTML, Markdown, CSV, JSON, YAML, or plain-text documents.
- [Table extraction](/services/document.tables): POST /v1/document/tables ($0.025 USDC) — Extract structured table rows and columns from supplied HTML, DOCX, or CSV documents.
- [PII and personal-data redaction](/services/document.redact): POST /v1/document/redact ($0.01 USDC) — Deterministically detect and redact PII and personal data in supplied text with overlap-safe matching for emails, phone numbers, validated IPv4 and IPv6 addresses, Luhn-valid payment cards, valid-checksum IBANs, and structurally valid US Social Security numbers.
- [Document diff](/services/document.diff): POST /v1/document/diff ($0.01 USDC) — Compare two texts and return structured line additions, removals, and a unified diff.
- [Dataset profile](/services/data.profile): POST /v1/data/profile ($0.025 USDC) — Profile CSV, JSON, or YAML records for field types, nulls, uniqueness, and representative samples.
- [Dataset cleaning](/services/data.clean): POST /v1/data/clean ($0.01 USDC) — Clean CSV, JSON, or YAML records by normalizing keys, trimming whitespace, and standardizing empty values.
- [Data conversion](/services/data.convert): POST /v1/data/convert ($0.005 USDC) — Convert structured data between CSV, JSON, and YAML formats with a machine-readable response.
- [Schema inference](/services/data.schema): POST /v1/data/schema ($0.025 USDC) — Infer a nested JSON Schema Draft 2020-12 contract from CSV, JSON, or YAML, including required fields, mixed and nullable types, array items, object properties, input evidence, and non-enforcing observed bounds.
- [JSON Schema validation](/services/data.schema-validate): POST /v1/data/schema-validate ($0.01 USDC) — Validate caller-supplied JSON against a bounded JSON Schema Draft 2020-12 contract with deterministic error pointers, format checks, input fingerprints, and no remote reference resolution.
- [Schema.org JSON-LD normalization](/services/data.schemaorg-normalize): POST /v1/data/schemaorg-normalize ($0.02 USDC) — Normalize caller-supplied inline Schema.org JSON-LD into deterministic Organization, Product, Service, Article, and Event entities with privacy scrubbing and field-level evidence hashes.
- [Record deduplication](/services/data.deduplicate): POST /v1/data/deduplicate ($0.01 USDC) — Remove duplicate CSV, JSON, or YAML records using selected identity fields and report the removed count.
- [x402 endpoint preflight](/services/developer.x402-preflight): POST /v1/developer/x402-preflight ($0.05 USDC) — Probe a public endpoint without paying and return an x402 v2 compliance grade, protocol evidence, and actionable remediation.
- [OpenAPI audit](/services/developer.openapi-audit): POST /v1/developer/openapi-audit ($0.05 USDC) — Validate and audit an OpenAPI document for missing operation IDs, descriptions, responses, and consistency problems.
- [Audit Python and npm dependencies for vulnerabilities](/services/developer.dependency-audit): POST /v1/developer/dependency-audit ($0.05 USDC) — Audit exact Python/PyPI, npm, Go, Maven, NuGet, crates.io, or RubyGems dependencies against OSV and return affected packages and vulnerabilities.
- [License compatibility audit](/services/developer.license-audit): POST /v1/developer/license-audit ($0.05 USDC) — Classify software dependency licenses and flag packages that need commercial or legal review.
- [Secret scan](/services/developer.secret-scan): POST /v1/developer/secret-scan ($0.05 USDC) — Scan source code or configuration text for leaked API keys, tokens, and credentials without returning secret values.
- [Code metrics](/services/developer.code-metrics): POST /v1/developer/code-metrics ($0.025 USDC) — Measure caller-supplied source code with Python AST analysis or a deterministic lexical fallback, including per-function complexity, a SHA-256 fingerprint, density ratios, syntax status, and actionable maintainability signals without retaining or forwarding the code.
- [Code change review](/services/developer.code-change-review): POST /v1/developer/code-change-review ($0.05 USDC) — Compare caller-supplied before and after source snapshots without execution or network access, returning source fingerprints, syntax regressions, structural deltas, function-level changes, and bounded review findings.
- [SQL change review](/services/developer.sql-change-review): POST /v1/developer/sql-change-review ($0.05 USDC) — Statically parse caller-supplied SQL without a database connection or execution, inventory statements and tables, and flag destructive DDL, unfiltered writes, and migration atomicity concerns.
- [Structured diff](/services/developer.structured-diff): POST /v1/developer/structured-diff ($0.01 USDC) — Compare JSON or YAML deterministically and return source hashes plus machine-readable additions, removals, and replacements by path with explicit truncation evidence.
- [Feed normalization](/services/research.feed-normalize): POST /v1/research/feed-normalize ($0.01 USDC) — Fetch and normalize public RSS or Atom feeds into stable structured JSON entries for agents and research workflows.
- [Multi-feed news aggregation](/services/research.news-aggregate): POST /v1/research/news-aggregate ($0.05 USDC) — Merge two to eight public RSS or Atom feeds into a filtered, deduplicated, time-ordered news stream with bounded partial-failure reporting.
- [OpenAPI pytest generator](/services/developer.openapi-test-generate): POST /v1/developer/openapi-test-generate ($0.1 USDC) — Generate deterministic, syntax-validated pytest and requests smoke tests from a caller-supplied OpenAPI 3 document, with mutating operations disabled by default.
- [U.S. federal contract search](/services/research.us-contract-search): POST /v1/research/us-contract-search ($0.02 USDC) — Search public USAspending prime federal procurement awards by recipient organization name, UEI, or legacy DUNS, returning bounded contract values, agencies, performance dates, descriptions, official award links, and explicit interpretation limits.
- [Federal Register document search](/services/research.federal-register-search): POST /v1/research/federal-register-search ($0.02 USDC) — Search newest U.S. Federal Register document metadata by topic, agency, type, and publication date, returning bounded regulatory notices, rules, proposed rules, presidential documents, and links to FederalRegister.gov and official govinfo.gov PDFs.
- [OFAC entity candidate evidence](/services/research.ofac-entity-search): POST /v1/research/ofac-entity-search ($0.02 USDC) — Compare a business or organization name with separately named Entity records and aliases in the official OFAC SDN and Consolidated Non-SDN files, returning deterministic candidate scores, program tags, source hashes, and freshness evidence without issuing an allow or block verdict.
- [Official organization evidence bundle](/services/research.organization-evidence): POST /v1/research/organization-evidence ($0.1 USDC) — Search one organization independently across official GLEIF legal-entity, USAspending prime-contract, SEC filing-activity, and OFAC Entity records, returning bounded evidence and source-specific coverage without asserting identity, linkage, risk, or compliance.
- [NHTSA vehicle VIN decoder](/services/data.vin-decode): POST /v1/data/vin-decode ($0.003 USDC) — Decode a full 17-character VIN into normalized NHTSA vPIC make, model, year, body, engine, transmission, plant, fuel, and occupancy fields with official source evidence and explicit missing-data semantics.
- [World Bank country indicator snapshot](/services/data.worldbank-snapshot): POST /v1/data/worldbank-snapshot ($0.005 USDC) — Bundle six official World Development Indicators into one normalized country snapshot with latest and previous GDP, growth, population, inflation, unemployment, and life-expectancy observations plus source and license evidence.
- [SEC filing activity signals](/services/research.sec-filing-signals): POST /v1/research/sec-filing-signals ($0.05 USDC) — Look up a public company by ticker or CIK, normalize recent SEC filings, and flag deterministic events such as late filings, amendments, auditor changes, non-reliance, control changes, or bankruptcy disclosures.
- [SEC Form 4 insider transactions](/services/research.sec-insider-transactions): POST /v1/research/sec-insider-transactions ($0.03 USDC) — Retrieve recent SEC Form 4 officer, director, and 10% beneficial-owner trades for a ticker or CIK, including purchases, sales, awards, exercises, tax withholding, prices, holdings, 10b5-1 context, derivatives, and filing footnotes.
- [SEC normalized financial facts](/services/research.sec-financial-facts): POST /v1/research/sec-financial-facts ($0.02 USDC) — Retrieve normalized, recent issuer-reported revenue, earnings, balance-sheet, cash-flow, and diluted-EPS facts from official SEC XBRL data.
- [SEC public company evidence bundle](/services/research.sec-company-evidence): POST /v1/research/sec-company-evidence ($0.01 USDC) — Resolve an exact SEC company name, ticker, or CIK, then bundle recent filing signals, normalized issuer-reported XBRL facts, and Form 4 insider transactions into one bounded public-company evidence report with explicit section coverage and official-source provenance.
- [US weather forecast](/services/data.us-weather-forecast): POST /v1/data/us-weather-forecast ($0.003 USDC) — Return normalized NOAA/NWS day/night or hourly forecast periods for supported U.S. coordinates, including precipitation probability, humidity, wind, timestamps, source provenance, and explicit coverage limitations.
- [EVM address inspection](/services/crypto.address-inspect): POST /v1/crypto/address-inspect ($0.002 USDC) — Validate and normalize an Ethereum or EVM wallet address, distinguish valid, absent, or invalid ERC-55 checksum casing, and identify the zero address without a network request.
- [Base account snapshot](/services/crypto.base-account-snapshot): POST /v1/crypto/base-account-snapshot ($0.01 USDC) — Read point-in-time ETH, native USDC, and up to four caller-selected ERC-20 balances plus account nonce and contract-code status at one resolved Base mainnet block.
- [Base account status](/services/crypto.base-account-status): POST /v1/crypto/base-account-status ($0.003 USDC) — Read ETH and native USDC balances, transaction nonce, and contract-code evidence for one wallet or contract address at a single resolved Base mainnet block.
- [Base USDC transfer history](/services/crypto.base-usdc-transfers): POST /v1/crypto/base-usdc-transfers ($0.005 USDC) — Retrieve newest-first incoming and outgoing Circle USDC Transfer events for one address across a validated, bounded Base mainnet block range.
- [Base contract event logs](/services/crypto.base-event-logs): POST /v1/crypto/base-event-logs ($0.003 USDC) — Query validated logs from one Base mainnet contract using a required event signature and at least one indexed topic value across a bounded resolved block range.
- [Base transaction gas estimate](/services/crypto.base-gas-estimate): POST /v1/crypto/base-gas-estimate ($0.004 USDC) — Estimate gas for one Base mainnet transaction context at a resolved block, add a bounded caller-selected buffer, and preserve RPC rejection evidence without signing or broadcasting.
- [Base network and fee status](/services/crypto.base-network-status): POST /v1/crypto/base-network-status ($0.001 USDC) — Read the latest Base mainnet block and a bounded EIP-1559 fee history in one RPC batch, including gas utilization and priority-fee percentile samples.
- [Base block inspection](/services/crypto.base-block-inspect): POST /v1/crypto/base-block-inspect ($0.001 USDC) — Inspect one historical Base mainnet block number or resolve a latest, safe, or finalized tag, returning bounded transaction, gas, fee, root, and head-distance evidence.
- [Base contract inspection](/services/crypto.base-contract-inspect): POST /v1/crypto/base-contract-inspect ($0.005 USDC) — Inspect Base mainnet contract bytecode, common token metadata, and ERC-165, ERC-721, and ERC-1155 interface signals at one resolved block.
- [Base contract read](/services/crypto.base-contract-read): POST /v1/crypto/base-contract-read ($0.005 USDC) — Execute one bounded read-only eth_call against a resolved Base mainnet block, retain call and block evidence, and optionally decode caller-specified ABI output types.
- [Base transaction inspection](/services/crypto.base-transaction-inspect): POST /v1/crypto/base-transaction-inspect ($0.005 USDC) — Inspect a Base mainnet transaction and receipt together, including execution outcome, confirmations, actual fee, recognized calldata, and bounded ERC-20-shaped transfer events with official Base USDC recognition.
- [Calldata decoder](/services/crypto.calldata-decode): POST /v1/crypto/calldata-decode ($0.001 USDC) — Resolve 29 common ERC-20, ERC-165, ERC-721, ERC-1155, ERC-2612, and ERC-3009 selectors without a network lookup, or strictly decode arbitrary Ethereum or EVM calldata using a supplied Solidity signature.
- [EIP-712 hash](/services/crypto.typed-data-hash): POST /v1/crypto/typed-data-hash ($0.01 USDC) — Validate EIP-712 typed structured data and derive its domain separator, message hash, and signing digest.

## Complete service reference

This reference is discovery documentation only. Reading it never executes or purchases a service. Every paid call requires its own HTTP 402 challenge and buyer-authorized payment capped at the listed exact USDC price.

### Web content extraction (`web.extract`)

Extract clean readable text or Markdown plus bounded structured links, canonical and heading signals, Schema.org types, redirect evidence, content hashes, and response provenance for research, RAG, or agent context.

- Endpoint: `POST https://apiacre.com/v1/web/extract`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.extract
- Browser checkout: https://apiacre.com/try/web.extract
- Tags: web, audit, scraping, markdown, url-to-markdown, rag, content, content-intelligence, structured-links, provenance

#### Request example

```json
{
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "output": {
      "default": "markdown",
      "pattern": "^(markdown|text)$",
      "title": "Output",
      "type": "string"
    },
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "ExtractInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "characters": 167,
    "content": "# Example Domain\n\nThis domain is for use in documentation examples without needing permission. Avoid use in operations.\n\n[Learn more](https://iana.org/domains/example)",
    "contentSha256": "5945db6fd8137aa377638814ca9bb1ac0a663fd90a97f11f86c3f5c09cfb40e3",
    "description": null,
    "extraction": {
      "javascriptRendered": false,
      "limitations": [
        "Client-rendered content is not executed.",
        "Markdown preserves readable block text, not the complete page layout.",
        "Structured links are bounded and exclude non-HTTP(S) targets."
      ],
      "linksPreserved": true,
      "method": "bounded HTML DOM extraction",
      "version": "apiacre-content-extract/3"
    },
    "format": "markdown",
    "language": "en",
    "links": {
      "detected": 1,
      "external": 1,
      "internal": 0,
      "items": [
        {
          "external": true,
          "text": "Learn more",
          "url": "https://iana.org/domains/example"
        }
      ],
      "returnLimit": 100,
      "returned": 1,
      "scanLimit": 500,
      "truncated": false
    },
    "pageSignals": {
      "alternateLanguageCount": 0,
      "canonicalUrl": null,
      "feedCount": 0,
      "headings": {
        "h1": [
          "Example Domain"
        ],
        "h2Count": 0,
        "h3Count": 0
      },
      "structuredData": {
        "blocks": 0,
        "invalidBlocks": 0,
        "truncated": false,
        "types": [],
        "validBlocks": 0
      }
    },
    "redirected": false,
    "requestedUrl": "https://example.com/",
    "response": {
      "bodySha256": "ff67a9d764d6a2367a187734e697f6a53217db9a21c101d410a113ca871a299d",
      "bytes": 559,
      "contentType": "text/html",
      "elapsedMs": 36,
      "statusCode": 200
    },
    "sha256": "5945db6fd8137aa377638814ca9bb1ac0a663fd90a97f11f86c3f5c09cfb40e3",
    "title": "Example Domain",
    "url": "https://example.com/",
    "words": 19
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.extract",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Web content extraction result",
      "properties": {
        "characters": {
          "type": "integer"
        },
        "content": {
          "type": "string"
        },
        "contentSha256": {
          "pattern": "^[0-9a-f]{64}$",
          "type": "string"
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "extraction": {
          "properties": {
            "javascriptRendered": {
              "const": false,
              "type": "boolean"
            },
            "limitations": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "linksPreserved": {
              "type": "boolean"
            },
            "method": {
              "const": "bounded HTML DOM extraction",
              "type": "string"
            },
            "version": {
              "const": "apiacre-content-extract/3",
              "type": "string"
            }
          },
          "required": [
            "version",
            "method",
            "javascriptRendered",
            "linksPreserved",
            "limitations"
          ],
          "type": "object"
        },
        "format": {
          "type": "string"
        },
        "language": {
          "type": [
            "string",
            "null"
          ]
        },
        "links": {
          "additionalProperties": false,
          "properties": {
            "detected": {
              "maximum": 500,
              "minimum": 0,
              "type": "integer"
            },
            "external": {
              "maximum": 500,
              "minimum": 0,
              "type": "integer"
            },
            "internal": {
              "maximum": 500,
              "minimum": 0,
              "type": "integer"
            },
            "items": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "external": {
                    "type": "boolean"
                  },
                  "text": {
                    "maxLength": 200,
                    "type": "string"
                  },
                  "url": {
                    "format": "uri",
                    "type": "string"
                  }
                },
                "required": [
                  "url",
                  "text",
                  "external"
                ],
                "type": "object"
              },
              "maxItems": 100,
              "type": "array"
            },
            "returnLimit": {
              "const": 100,
              "type": "integer"
            },
            "returned": {
              "maximum": 100,
              "minimum": 0,
              "type": "integer"
            },
            "scanLimit": {
              "const": 500,
              "type": "integer"
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "detected",
            "returned",
            "internal",
            "external",
            "truncated",
            "scanLimit",
            "returnLimit",
            "items"
          ],
          "type": "object"
        },
        "pageSignals": {
          "additionalProperties": false,
          "properties": {
            "alternateLanguageCount": {
              "maximum": 50,
              "minimum": 0,
              "type": "integer"
            },
            "canonicalUrl": {
              "format": "uri",
              "type": [
                "string",
                "null"
              ]
            },
            "feedCount": {
              "maximum": 20,
              "minimum": 0,
              "type": "integer"
            },
            "headings": {
              "additionalProperties": false,
              "properties": {
                "h1": {
                  "items": {
                    "type": "string"
                  },
                  "maxItems": 10,
                  "type": "array"
                },
                "h2Count": {
                  "minimum": 0,
                  "type": "integer"
                },
                "h3Count": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "h1",
                "h2Count",
                "h3Count"
              ],
              "type": "object"
            },
            "structuredData": {
              "additionalProperties": false,
              "properties": {
                "blocks": {
                  "minimum": 0,
                  "type": "integer"
                },
                "invalidBlocks": {
                  "minimum": 0,
                  "type": "integer"
                },
                "truncated": {
                  "type": "boolean"
                },
                "types": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "validBlocks": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "blocks",
                "validBlocks",
                "invalidBlocks",
                "types",
                "truncated"
              ],
              "type": "object"
            }
          },
          "required": [
            "canonicalUrl",
            "headings",
            "structuredData",
            "feedCount",
            "alternateLanguageCount"
          ],
          "type": "object"
        },
        "redirected": {
          "type": "boolean"
        },
        "requestedUrl": {
          "format": "uri",
          "type": "string"
        },
        "response": {
          "properties": {
            "bodySha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "bytes": {
              "minimum": 0,
              "type": "integer"
            },
            "contentType": {
              "type": [
                "string",
                "null"
              ]
            },
            "elapsedMs": {
              "minimum": 0,
              "type": "integer"
            },
            "statusCode": {
              "maximum": 599,
              "minimum": 100,
              "type": "integer"
            }
          },
          "required": [
            "statusCode",
            "contentType",
            "elapsedMs",
            "bytes",
            "bodySha256"
          ],
          "type": "object"
        },
        "sha256": {
          "pattern": "^[0-9a-f]{64}$",
          "type": "string"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "format": "uri",
          "type": "string"
        },
        "words": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.extract",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Metadata extraction (`web.metadata`)

Extract an agent-ready public-page metadata record with redirects, response provenance, canonical and alternate URLs, headings, icons, feeds, social cards, Schema.org types, and privacy-safe publisher-asserted Organization facts with field evidence.

- Endpoint: `POST https://apiacre.com/v1/web/metadata`
- Exact price: `$0.002 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.metadata
- Browser checkout: https://apiacre.com/try/web.metadata
- Tags: web, audit, metadata, open-graph, social, canonical, schema.org, hreflang, enrichment

#### Request example

```json
{
  "url": "https://apiacre.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "alternates": [],
    "canonical": "https://apiacre.com",
    "description": "61 pay-per-call APIs for agents, settled in USDC on Base through x402.",
    "document": {
      "author": null,
      "charset": "utf-8",
      "generator": null,
      "robots": "index,follow",
      "themeColor": null,
      "viewport": "width=device-width,initial-scale=1"
    },
    "feeds": [],
    "headings": {
      "h1": [
        "Useful APIs. One call at a time."
      ],
      "h2Count": 2,
      "h3Count": 55
    },
    "icons": [],
    "language": "en",
    "openGraph": {
      "description": "Buy focused web, document, developer, research, and EVM results with USDC over x402.",
      "image": null,
      "imageAlt": null,
      "locale": null,
      "siteName": null,
      "title": "API Acre \u2014 Pay-per-call APIs on Base",
      "type": "website",
      "url": "https://apiacre.com"
    },
    "redirected": false,
    "requestedUrl": "https://apiacre.com/",
    "response": {
      "bodySha256": "3886972b5512bf62a93dbdf790af504cab300572de9837088909ebd4aa3a3b4e",
      "bytes": 21633,
      "contentType": "text/html; charset=utf-8",
      "elapsedMs": 42,
      "statusCode": 200
    },
    "structuredData": {
      "blocks": 1,
      "invalidBlocks": 0,
      "organizationFacts": {
        "additionalNetworkRequestsMade": 0,
        "conflicts": [],
        "domainOwnershipVerified": false,
        "identityVerified": false,
        "legalStatusVerified": false,
        "limits": {
          "maxDepth": 20,
          "maxInputCharacters": 500000,
          "maxObjectNodes": 500,
          "maxScriptsProcessed": 100,
          "processingBudgetMs": 1000
        },
        "method": "apiacre-schemaorg-organization-facts/1",
        "nodesSeen": 2,
        "organizations": [
          {
            "evidence": [
              {
                "blockIndex": 0,
                "field": "name",
                "jsonPointer": "/provider/name",
                "valueSha256": "8538606619feeaf0e13ae5d29a5a81970b47bedc403e6468475c08209c140da7"
              },
              {
                "blockIndex": 0,
                "field": "url",
                "jsonPointer": "/provider/url",
                "valueSha256": "2995a6567e3c0dfe6fca040f7bc2c4de577ed3f777d5e6548ed3986557d2a44b"
              }
            ],
            "fields": {
              "name": "API Acre",
              "url": "https://apiacre.com"
            },
            "id": null,
            "type": "Organization"
          }
        ],
        "organizationsReturned": 1,
        "publisherAsserted": true,
        "scope": "Publisher-asserted Schema.org Organization facts; not verification of identity, domain ownership, or legal status. Person and contact fields are excluded.",
        "scriptsProcessed": 1,
        "scriptsSeen": 1,
        "sourceScriptsSha256": "0afe4ab775e3985222320128f13c95ea10bf90021a8a8915479873f26f2fc40d",
        "status": "complete",
        "vocabulary": {
          "license": "CC BY-SA 3.0",
          "licenseUrl": "https://creativecommons.org/licenses/by-sa/3.0/",
          "name": "Schema.org",
          "url": "https://schema.org/"
        },
        "warnings": []
      },
      "truncated": false,
      "types": [
        "Organization",
        "WebAPI"
      ],
      "validBlocks": 1
    },
    "title": "API Acre \u2014 Pay-per-call APIs on Base",
    "twitter": {
      "card": null,
      "creator": null,
      "description": null,
      "image": null,
      "imageAlt": null,
      "site": null,
      "title": null
    },
    "url": "https://apiacre.com/"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "output": "markdown",
          "url": "$request.url"
        },
        "method": "POST",
        "path": "/v1/web/extract",
        "price": "$0.01",
        "reason": "Retrieve the same public URL as clean text or Markdown with bounded structured links and page signals for downstream research or RAG.",
        "service": "web.extract",
        "title": "Web content extraction",
        "use_output": "Use result.data.content as the normalized page body, result.data.links as a bounded link inventory, and the hashes as fetch-specific provenance."
      },
      {
        "authorization_required": true,
        "input_template": {
          "content": "$json($result.data)",
          "format": "json"
        },
        "method": "POST",
        "path": "/v1/data/schema",
        "price": "$0.025",
        "reason": "Turn the normalized metadata result into a reusable validation contract.",
        "service": "data.schema",
        "title": "Schema inference",
        "use_output": "Persist result.data.schema to validate future metadata records."
      },
      {
        "authorization_required": true,
        "input_template": {
          "url": "$request.url"
        },
        "method": "POST",
        "path": "/v1/web/domain-intelligence",
        "price": "$0.02",
        "reason": "Add DNS, TLS, RDAP, mail-policy, and domain-age evidence for the same public website.",
        "service": "web.domain-intelligence",
        "title": "Domain intelligence",
        "use_output": "Use result.data.signals and warnings as bounded technical domain evidence; do not treat them as an ownership or safety verdict."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.metadata",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Metadata extraction result",
      "properties": {
        "alternates": {
          "items": {},
          "type": "array"
        },
        "canonical": {
          "type": [
            "string",
            "null"
          ]
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "document": {
          "type": "object"
        },
        "feeds": {
          "items": {},
          "type": "array"
        },
        "headings": {
          "type": "object"
        },
        "icons": {
          "items": {},
          "type": "array"
        },
        "language": {
          "type": [
            "string",
            "null"
          ]
        },
        "openGraph": {
          "type": "object"
        },
        "redirected": {
          "type": "boolean"
        },
        "requestedUrl": {
          "type": "string"
        },
        "response": {
          "type": "object"
        },
        "structuredData": {
          "additionalProperties": false,
          "description": "Bounded JSON-LD inventory plus privacy-safe, publisher-asserted Organization facts. These facts do not verify identity, domain ownership, or legal status.",
          "properties": {
            "blocks": {
              "minimum": 0,
              "type": "integer"
            },
            "invalidBlocks": {
              "minimum": 0,
              "type": "integer"
            },
            "organizationFacts": {
              "additionalProperties": false,
              "properties": {
                "additionalNetworkRequestsMade": {
                  "const": 0,
                  "type": "integer"
                },
                "conflicts": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "discardedValueSha256": {
                        "pattern": "^[0-9a-f]{64}$",
                        "type": "string"
                      },
                      "entity": {
                        "type": "string"
                      },
                      "field": {
                        "type": "string"
                      },
                      "keptValueSha256": {
                        "pattern": "^[0-9a-f]{64}$",
                        "type": "string"
                      }
                    },
                    "required": [
                      "entity",
                      "field",
                      "keptValueSha256",
                      "discardedValueSha256"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "domainOwnershipVerified": {
                  "const": false,
                  "type": "boolean"
                },
                "identityVerified": {
                  "const": false,
                  "type": "boolean"
                },
                "legalStatusVerified": {
                  "const": false,
                  "type": "boolean"
                },
                "limits": {
                  "additionalProperties": false,
                  "properties": {
                    "maxDepth": {
                      "const": 20,
                      "type": "integer"
                    },
                    "maxInputCharacters": {
                      "const": 500000,
                      "type": "integer"
                    },
                    "maxObjectNodes": {
                      "const": 500,
                      "type": "integer"
                    },
                    "maxScriptsProcessed": {
                      "const": 100,
                      "type": "integer"
                    },
                    "processingBudgetMs": {
                      "const": 1000,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "maxScriptsProcessed",
                    "maxInputCharacters",
                    "maxObjectNodes",
                    "maxDepth",
                    "processingBudgetMs"
                  ],
                  "type": "object"
                },
                "method": {
                  "const": "apiacre-schemaorg-organization-facts/1",
                  "type": "string"
                },
                "nodesSeen": {
                  "minimum": 0,
                  "type": "integer"
                },
                "organizations": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "evidence": {
                        "items": {
                          "additionalProperties": false,
                          "properties": {
                            "blockIndex": {
                              "minimum": 0,
                              "type": "integer"
                            },
                            "field": {
                              "enum": [
                                "name",
                                "url",
                                "image",
                                "description",
                                "legalName",
                                "logo",
                                "sameAs"
                              ],
                              "type": "string"
                            },
                            "jsonPointer": {
                              "type": "string"
                            },
                            "valueSha256": {
                              "pattern": "^[0-9a-f]{64}$",
                              "type": "string"
                            }
                          },
                          "required": [
                            "field",
                            "blockIndex",
                            "jsonPointer",
                            "valueSha256"
                          ],
                          "type": "object"
                        },
                        "type": "array"
                      },
                      "fields": {
                        "additionalProperties": false,
                        "properties": {
                          "description": {
                            "type": [
                              "string",
                              "number",
                              "boolean"
                            ]
                          },
                          "image": {
                            "oneOf": [
                              {
                                "type": "string"
                              },
                              {
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              }
                            ]
                          },
                          "legalName": {
                            "type": [
                              "string",
                              "number",
                              "boolean"
                            ]
                          },
                          "logo": {
                            "oneOf": [
                              {
                                "type": "string"
                              },
                              {
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              }
                            ]
                          },
                          "name": {
                            "type": [
                              "string",
                              "number",
                              "boolean"
                            ]
                          },
                          "sameAs": {
                            "items": {
                              "type": "string"
                            },
                            "type": "array",
                            "uniqueItems": true
                          },
                          "url": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "id": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "type": {
                        "const": "Organization",
                        "type": "string"
                      }
                    },
                    "required": [
                      "type",
                      "id",
                      "fields",
                      "evidence"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "organizationsReturned": {
                  "minimum": 0,
                  "type": "integer"
                },
                "publisherAsserted": {
                  "const": true,
                  "type": "boolean"
                },
                "scope": {
                  "type": "string"
                },
                "scriptsProcessed": {
                  "maximum": 100,
                  "minimum": 0,
                  "type": "integer"
                },
                "scriptsSeen": {
                  "minimum": 0,
                  "type": "integer"
                },
                "sourceScriptsSha256": {
                  "pattern": "^[0-9a-f]{64}$",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "status": {
                  "enum": [
                    "none",
                    "complete",
                    "truncated",
                    "skipped_oversize",
                    "skipped_invalid_or_complex"
                  ],
                  "type": "string"
                },
                "vocabulary": {
                  "additionalProperties": false,
                  "properties": {
                    "license": {
                      "const": "CC BY-SA 3.0",
                      "type": "string"
                    },
                    "licenseUrl": {
                      "format": "uri",
                      "type": "string"
                    },
                    "name": {
                      "const": "Schema.org",
                      "type": "string"
                    },
                    "url": {
                      "format": "uri",
                      "type": "string"
                    }
                  },
                  "required": [
                    "name",
                    "url",
                    "license",
                    "licenseUrl"
                  ],
                  "type": "object"
                },
                "warnings": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "status",
                "method",
                "scope",
                "publisherAsserted",
                "identityVerified",
                "domainOwnershipVerified",
                "legalStatusVerified",
                "additionalNetworkRequestsMade",
                "sourceScriptsSha256",
                "vocabulary",
                "scriptsSeen",
                "scriptsProcessed",
                "nodesSeen",
                "organizationsReturned",
                "organizations",
                "conflicts",
                "warnings",
                "limits"
              ],
              "type": "object"
            },
            "truncated": {
              "type": "boolean"
            },
            "types": {
              "items": {
                "type": "string"
              },
              "type": "array",
              "uniqueItems": true
            },
            "validBlocks": {
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "blocks",
            "validBlocks",
            "invalidBlocks",
            "types",
            "truncated",
            "organizationFacts"
          ],
          "type": "object"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "twitter": {
          "type": "object"
        },
        "url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.metadata",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### SEO audit (`web.seo-audit`)

Audit on-page technical SEO, score a public URL, and return prioritized, actionable issues for search optimization.

- Endpoint: `POST https://apiacre.com/v1/web/seo-audit`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.seo-audit
- Browser checkout: https://apiacre.com/try/web.seo-audit
- Tags: web, audit, seo, website, search

#### Request example

```json
{
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "headings": {
      "h1": 1,
      "h2": 0,
      "h3": 0
    },
    "imageCount": 0,
    "imagesMissingAlt": 0,
    "issues": [
      {
        "code": "missing_meta_description",
        "severity": "medium"
      }
    ],
    "metadata": {
      "alternates": [],
      "canonical": null,
      "description": null,
      "document": {
        "author": null,
        "charset": null,
        "generator": null,
        "robots": null,
        "themeColor": null,
        "viewport": "width=device-width, initial-scale=1"
      },
      "feeds": [],
      "headings": {
        "h1": [
          "Example Domain"
        ],
        "h2Count": 0,
        "h3Count": 0
      },
      "icons": [
        {
          "rel": "icon",
          "sizes": null,
          "type": null,
          "url": "data:,"
        }
      ],
      "language": "en",
      "openGraph": {
        "description": null,
        "image": null,
        "imageAlt": null,
        "locale": null,
        "siteName": null,
        "title": null,
        "type": null,
        "url": null
      },
      "structuredData": {
        "blocks": 0,
        "invalidBlocks": 0,
        "truncated": false,
        "types": [],
        "validBlocks": 0
      },
      "title": "Example Domain",
      "twitter": {
        "card": null,
        "creator": null,
        "description": null,
        "image": null,
        "imageAlt": null,
        "site": null,
        "title": null
      },
      "url": "https://example.com/"
    },
    "score": 90,
    "wordCount": 21
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "url": "$request.url"
        },
        "method": "POST",
        "path": "/v1/web/full-audit",
        "price": "$0.25",
        "reason": "Extend the page-level SEO result with security, accessibility, and performance checks.",
        "service": "web.full-audit",
        "title": "Full site audit",
        "use_output": "Use the combined scores and findings to prioritize a broader site-quality pass."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.seo-audit",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured SEO audit result",
      "properties": {
        "headings": {
          "type": "object"
        },
        "imageCount": {
          "type": "integer"
        },
        "imagesMissingAlt": {
          "type": "integer"
        },
        "issues": {
          "items": {},
          "type": "array"
        },
        "metadata": {
          "type": "object"
        },
        "score": {
          "type": "integer"
        },
        "wordCount": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.seo-audit",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Web security audit (`web.security-audit`)

Scan a public website for TLS and browser security header weaknesses and return a security score with fixes.

- Endpoint: `POST https://apiacre.com/v1/web/security-audit`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.security-audit
- Browser checkout: https://apiacre.com/try/web.security-audit
- Tags: web, audit, security, headers, tls, website, vulnerability

#### Request example

```json
{
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "cookieFlags": [],
    "missing": [],
    "present": [],
    "score": 1,
    "url": "https://example.com"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.security-audit",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Web security audit result",
      "properties": {
        "cookieFlags": {
          "items": {},
          "type": "array"
        },
        "missing": {
          "items": {},
          "type": "array"
        },
        "present": {
          "items": {},
          "type": "array"
        },
        "score": {
          "type": "integer"
        },
        "url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.security-audit",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Accessibility audit (`web.accessibility-audit`)

Check a public page for deterministic HTML accessibility problems and return actionable WCAG-oriented findings.

- Endpoint: `POST https://apiacre.com/v1/web/accessibility-audit`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.accessibility-audit
- Browser checkout: https://apiacre.com/try/web.accessibility-audit
- Tags: web, audit, accessibility, wcag, a11y, website

#### Request example

```json
{
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "issueCount": 1,
    "issues": [],
    "score": 1
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.accessibility-audit",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Accessibility audit result",
      "properties": {
        "issueCount": {
          "type": "integer"
        },
        "issues": {
          "items": {},
          "type": "array"
        },
        "score": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.accessibility-audit",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Performance profile (`web.performance-profile`)

Measure website response latency, payload size, compression, caching, and performance signals for a public URL.

- Endpoint: `POST https://apiacre.com/v1/web/performance-profile`
- Exact price: `$0.025 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.performance-profile
- Browser checkout: https://apiacre.com/try/web.performance-profile
- Tags: web, audit, performance, speed, latency, website, profiling

#### Request example

```json
{
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "bytes": 559,
    "cacheControl": null,
    "compression": "gzip",
    "elapsedMs": 40,
    "serverTiming": null,
    "status": 200,
    "url": "https://example.com/"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.performance-profile",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Performance profile result",
      "properties": {
        "bytes": {
          "type": "integer"
        },
        "cacheControl": {
          "type": [
            "string",
            "null"
          ]
        },
        "compression": {
          "type": "string"
        },
        "elapsedMs": {
          "type": "integer"
        },
        "serverTiming": {
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "type": "integer"
        },
        "url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.performance-profile",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Link and site-map analysis (`web.links`)

Extract and classify links from one public page or safely crawl up to 10 same-origin pages into an agent-ready site map with page provenance, depth limits, and robots.txt enforcement.

- Endpoint: `POST https://apiacre.com/v1/web/links`
- Exact price: `$0.005 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.links
- Browser checkout: https://apiacre.com/try/web.links
- Tags: web, audit, links, crawl, site-map, website, extraction, robots

#### Request example

```json
{
  "include_external": true,
  "max_depth": 2,
  "max_pages": 3,
  "respect_robots": true,
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "include_external": {
      "default": true,
      "title": "Include External",
      "type": "boolean"
    },
    "max_depth": {
      "default": 1,
      "maximum": 3,
      "minimum": 0,
      "title": "Max Depth",
      "type": "integer"
    },
    "max_pages": {
      "default": 1,
      "maximum": 10,
      "minimum": 1,
      "title": "Max Pages",
      "type": "integer"
    },
    "respect_robots": {
      "default": true,
      "title": "Respect Robots",
      "type": "boolean"
    },
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "LinksInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "count": 1,
    "crawl": {
      "enabled": true,
      "linkLimitPerPage": 500,
      "maxDepth": 2,
      "maxPages": 3,
      "pagesAttempted": 1,
      "pagesFailed": 0,
      "pagesFetched": 1,
      "pagesSkipped": 0,
      "robots": {
        "respected": true,
        "status": "http_404",
        "url": "https://example.com/robots.txt"
      },
      "sameOriginOnly": true,
      "truncated": false
    },
    "errors": [],
    "external": 1,
    "internal": 0,
    "links": [
      {
        "external": true,
        "text": "Learn more",
        "url": "https://iana.org/domains/example"
      }
    ],
    "origin": "https://example.com",
    "pages": [
      {
        "bodySha256": "ff67a9d764d6a2367a187734e697f6a53217db9a21c101d410a113ca871a299d",
        "bytes": 559,
        "depth": 0,
        "discoveredFrom": null,
        "elapsedMs": 41,
        "external": 1,
        "internal": 0,
        "linkCount": 1,
        "statusCode": 200,
        "title": "Example Domain",
        "url": "https://example.com/"
      }
    ],
    "skipped": [],
    "url": "https://example.com/"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "url": "$request.url"
        },
        "method": "POST",
        "path": "/v1/web/robots-sitemap",
        "price": "$0.025",
        "reason": "Compare crawl-discovered pages with robots.txt rules and declared XML sitemap coverage.",
        "service": "web.robots-sitemap",
        "title": "Robots and sitemap audit",
        "use_output": "Reconcile result.data.sitemap.urlCount and robots rules with the crawl inventory."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.links",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Link and site-map analysis result",
      "properties": {
        "count": {
          "type": "integer"
        },
        "crawl": {
          "type": "object"
        },
        "errors": {
          "items": {},
          "type": "array"
        },
        "external": {
          "type": "integer"
        },
        "internal": {
          "type": "integer"
        },
        "links": {
          "items": {},
          "type": "array"
        },
        "origin": {
          "type": "string"
        },
        "pages": {
          "items": {},
          "type": "array"
        },
        "skipped": {
          "items": {},
          "type": "array"
        },
        "url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.links",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Robots and sitemap audit (`web.robots-sitemap`)

Inspect a domain's robots.txt crawl rules and XML sitemap health, availability, and URL count.

- Endpoint: `POST https://apiacre.com/v1/web/robots-sitemap`
- Exact price: `$0.025 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.robots-sitemap
- Browser checkout: https://apiacre.com/try/web.robots-sitemap
- Tags: web, audit, robots, sitemap, crawler, seo, website

#### Request example

```json
{
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "origin": "example",
    "robots": {},
    "sitemap": {}
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.robots-sitemap",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Robots and sitemap audit result",
      "properties": {
        "origin": {
          "type": "string"
        },
        "robots": {
          "type": "object"
        },
        "sitemap": {
          "type": "object"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.robots-sitemap",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Technology fingerprint (`web.tech-fingerprint`)

Identify frameworks, analytics, CDNs, servers, and other website technologies from public response signals.

- Endpoint: `POST https://apiacre.com/v1/web/tech-fingerprint`
- Exact price: `$0.025 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.tech-fingerprint
- Browser checkout: https://apiacre.com/try/web.tech-fingerprint
- Tags: web, audit, technology, fingerprint, stack, website

#### Request example

```json
{
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "poweredBy": null,
    "scriptHosts": [],
    "server": "cloudflare",
    "technologies": [
      "Cloudflare"
    ],
    "url": "https://example.com/"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.tech-fingerprint",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Technology fingerprint result",
      "properties": {
        "poweredBy": {
          "type": [
            "string",
            "null"
          ]
        },
        "scriptHosts": {
          "items": {},
          "type": "array"
        },
        "server": {
          "type": "string"
        },
        "technologies": {
          "items": {},
          "type": "array"
        },
        "url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.tech-fingerprint",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Email authentication posture (`web.email-auth`)

Check a public domain's email authentication and anti-spoofing posture using MX, SPF, DMARC, caller-selected DKIM, MTA-STS, TLS-RPT, and BIMI DNS evidence.

- Endpoint: `POST https://apiacre.com/v1/web/email-auth`
- Exact price: `$0.005 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.email-auth
- Browser checkout: https://apiacre.com/try/web.email-auth
- Tags: web, audit, email-authentication, dns, spf, dmarc, dkim, anti-spoofing, deliverability

#### Request example

```json
{
  "dkim_selectors": [
    "protonmail"
  ],
  "domain": "apiacre.com"
}
```

#### Input schema

```json
{
  "properties": {
    "dkim_selectors": {
      "description": "Optional known DKIM selectors to query; selectors cannot be discovered reliably from DNS alone",
      "examples": [
        [
          "protonmail"
        ]
      ],
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "title": "Dkim Selectors",
      "type": "array"
    },
    "domain": {
      "description": "Public DNS domain to inspect without a URL scheme or path",
      "examples": [
        "apiacre.com"
      ],
      "maxLength": 253,
      "minLength": 3,
      "title": "Domain",
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "title": "EmailAuthInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "checkedAt": "2026-08-12T18:03:16+00:00",
    "collectionMs": 19,
    "dkim": {
      "checked": true,
      "checkedSelectors": [
        "protonmail"
      ],
      "reason": null,
      "selectors": [
        {
          "configured": true,
          "keyType": "rsa",
          "multipleRecords": false,
          "publicKeySha256": "cc2f27246460f945974ac7bf0282287809d7f7c76757b4cdad5590fa38a80f69",
          "recordCount": 1,
          "revoked": false,
          "selector": "protonmail"
        }
      ]
    },
    "dmarc": {
      "aggregateReportingConfigured": false,
      "configured": true,
      "dkimAlignment": null,
      "forensicReportingConfigured": false,
      "multipleRecords": false,
      "percentage": null,
      "policy": "quarantine",
      "recordCount": 1,
      "records": [
        "v=DMARC1; p=quarantine"
      ],
      "spfAlignment": null,
      "subdomainPolicy": null
    },
    "domain": "apiacre.com",
    "findings": [],
    "limitations": [
      "DNS answers are a time-specific recursive-resolver snapshot and may be cached.",
      "DKIM is checked only for selectors explicitly supplied by the caller.",
      "Published records do not prove delivery, domain ownership, sender identity, or message authenticity."
    ],
    "mailRouting": {
      "addressFallbackObserved": true,
      "mode": "explicit_mx",
      "mxRecords": [
        "10 mail.protonmail.ch.",
        "20 mailsec.protonmail.ch."
      ],
      "nullMx": false
    },
    "optionalPolicies": {
      "bimi": {
        "configured": false,
        "recordCount": 0,
        "records": []
      },
      "mtaSts": {
        "configured": false,
        "recordCount": 0,
        "records": []
      },
      "tlsReporting": {
        "configured": false,
        "recordCount": 0,
        "records": []
      }
    },
    "posture": {
      "basis": "published DNS records only",
      "status": "enforcing"
    },
    "provenance": {
      "queries": [
        "apiacre.com A",
        "apiacre.com AAAA",
        "apiacre.com MX",
        "apiacre.com TXT",
        "_dmarc.apiacre.com TXT",
        "protonmail._domainkey.apiacre.com TXT",
        "_mta-sts.apiacre.com TXT",
        "_smtp._tls.apiacre.com TXT",
        "default._bimi.apiacre.com TXT"
      ],
      "queryCount": 9,
      "source": "recursive DNS"
    },
    "spf": {
      "allQualifier": "softfail",
      "configured": true,
      "directDnsMechanismCount": 1,
      "multipleRecords": false,
      "recordCount": 1,
      "records": [
        "v=spf1 include:_spf.protonmail.ch ~all"
      ]
    }
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.email-auth",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured Email authentication posture result",
      "properties": {
        "checkedAt": {
          "format": "date-time",
          "type": "string"
        },
        "collectionMs": {
          "minimum": 0,
          "type": "integer"
        },
        "dkim": {
          "additionalProperties": false,
          "properties": {
            "checked": {
              "type": "boolean"
            },
            "checkedSelectors": {
              "items": {
                "maxLength": 100,
                "type": "string"
              },
              "maxItems": 5,
              "type": "array",
              "uniqueItems": true
            },
            "reason": {
              "maxLength": 300,
              "type": [
                "string",
                "null"
              ]
            },
            "selectors": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "configured": {
                    "type": "boolean"
                  },
                  "keyType": {
                    "maxLength": 30,
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "multipleRecords": {
                    "type": "boolean"
                  },
                  "publicKeySha256": {
                    "pattern": "^[0-9a-f]{64}$",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "recordCount": {
                    "maximum": 30,
                    "minimum": 0,
                    "type": "integer"
                  },
                  "revoked": {
                    "type": "boolean"
                  },
                  "selector": {
                    "maxLength": 100,
                    "type": "string"
                  }
                },
                "required": [
                  "selector",
                  "configured",
                  "recordCount",
                  "multipleRecords",
                  "revoked",
                  "keyType",
                  "publicKeySha256"
                ],
                "type": "object"
              },
              "maxItems": 5,
              "type": "array"
            }
          },
          "required": [
            "checked",
            "checkedSelectors",
            "selectors",
            "reason"
          ],
          "type": "object"
        },
        "dmarc": {
          "additionalProperties": false,
          "properties": {
            "aggregateReportingConfigured": {
              "type": "boolean"
            },
            "configured": {
              "type": "boolean"
            },
            "dkimAlignment": {
              "maxLength": 20,
              "type": [
                "string",
                "null"
              ]
            },
            "forensicReportingConfigured": {
              "type": "boolean"
            },
            "multipleRecords": {
              "type": "boolean"
            },
            "percentage": {
              "maximum": 100,
              "minimum": 0,
              "type": [
                "integer",
                "null"
              ]
            },
            "policy": {
              "maxLength": 30,
              "type": [
                "string",
                "null"
              ]
            },
            "recordCount": {
              "maximum": 30,
              "minimum": 0,
              "type": "integer"
            },
            "records": {
              "items": {
                "maxLength": 2000,
                "type": "string"
              },
              "maxItems": 30,
              "type": "array"
            },
            "spfAlignment": {
              "maxLength": 20,
              "type": [
                "string",
                "null"
              ]
            },
            "subdomainPolicy": {
              "maxLength": 30,
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "configured",
            "recordCount",
            "records",
            "multipleRecords",
            "policy",
            "subdomainPolicy",
            "percentage",
            "aggregateReportingConfigured",
            "forensicReportingConfigured",
            "dkimAlignment",
            "spfAlignment"
          ],
          "type": "object"
        },
        "domain": {
          "format": "hostname",
          "maxLength": 253,
          "type": "string"
        },
        "findings": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "code": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string"
              },
              "level": {
                "enum": [
                  "info",
                  "warning"
                ],
                "type": "string"
              },
              "message": {
                "maxLength": 500,
                "type": "string"
              }
            },
            "required": [
              "level",
              "code",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "limitations": {
          "items": {
            "maxLength": 500,
            "type": "string"
          },
          "maxItems": 3,
          "minItems": 3,
          "type": "array"
        },
        "mailRouting": {
          "additionalProperties": false,
          "properties": {
            "addressFallbackObserved": {
              "type": "boolean"
            },
            "mode": {
              "enum": [
                "null_mx",
                "explicit_mx",
                "implicit_address_fallback",
                "not_observed"
              ],
              "type": "string"
            },
            "mxRecords": {
              "items": {
                "maxLength": 2000,
                "type": "string"
              },
              "maxItems": 30,
              "type": "array"
            },
            "nullMx": {
              "type": "boolean"
            }
          },
          "required": [
            "mode",
            "mxRecords",
            "nullMx",
            "addressFallbackObserved"
          ],
          "type": "object"
        },
        "optionalPolicies": {
          "additionalProperties": false,
          "properties": {
            "bimi": {
              "additionalProperties": false,
              "properties": {
                "configured": {
                  "type": "boolean"
                },
                "recordCount": {
                  "maximum": 30,
                  "minimum": 0,
                  "type": "integer"
                },
                "records": {
                  "items": {
                    "maxLength": 2000,
                    "type": "string"
                  },
                  "maxItems": 30,
                  "type": "array"
                }
              },
              "required": [
                "configured",
                "recordCount",
                "records"
              ],
              "type": "object"
            },
            "mtaSts": {
              "additionalProperties": false,
              "properties": {
                "configured": {
                  "type": "boolean"
                },
                "recordCount": {
                  "maximum": 30,
                  "minimum": 0,
                  "type": "integer"
                },
                "records": {
                  "items": {
                    "maxLength": 2000,
                    "type": "string"
                  },
                  "maxItems": 30,
                  "type": "array"
                }
              },
              "required": [
                "configured",
                "recordCount",
                "records"
              ],
              "type": "object"
            },
            "tlsReporting": {
              "additionalProperties": false,
              "properties": {
                "configured": {
                  "type": "boolean"
                },
                "recordCount": {
                  "maximum": 30,
                  "minimum": 0,
                  "type": "integer"
                },
                "records": {
                  "items": {
                    "maxLength": 2000,
                    "type": "string"
                  },
                  "maxItems": 30,
                  "type": "array"
                }
              },
              "required": [
                "configured",
                "recordCount",
                "records"
              ],
              "type": "object"
            }
          },
          "required": [
            "mtaSts",
            "tlsReporting",
            "bimi"
          ],
          "type": "object"
        },
        "posture": {
          "additionalProperties": false,
          "properties": {
            "basis": {
              "const": "published DNS records only",
              "type": "string"
            },
            "status": {
              "enum": [
                "enforcing",
                "monitoring",
                "incomplete",
                "no_mail_declared"
              ],
              "type": "string"
            }
          },
          "required": [
            "status",
            "basis"
          ],
          "type": "object"
        },
        "provenance": {
          "additionalProperties": false,
          "properties": {
            "queries": {
              "items": {
                "maxLength": 400,
                "type": "string"
              },
              "maxItems": 13,
              "minItems": 8,
              "type": "array"
            },
            "queryCount": {
              "maximum": 13,
              "minimum": 8,
              "type": "integer"
            },
            "source": {
              "const": "recursive DNS",
              "type": "string"
            }
          },
          "required": [
            "source",
            "queries",
            "queryCount"
          ],
          "type": "object"
        },
        "spf": {
          "additionalProperties": false,
          "properties": {
            "allQualifier": {
              "enum": [
                "fail",
                "softfail",
                "neutral",
                "pass",
                null
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "configured": {
              "type": "boolean"
            },
            "directDnsMechanismCount": {
              "minimum": 0,
              "type": "integer"
            },
            "multipleRecords": {
              "type": "boolean"
            },
            "recordCount": {
              "maximum": 30,
              "minimum": 0,
              "type": "integer"
            },
            "records": {
              "items": {
                "maxLength": 2000,
                "type": "string"
              },
              "maxItems": 30,
              "type": "array"
            }
          },
          "required": [
            "configured",
            "recordCount",
            "records",
            "multipleRecords",
            "allQualifier",
            "directDnsMechanismCount"
          ],
          "type": "object"
        }
      },
      "required": [
        "domain",
        "mailRouting",
        "spf",
        "dmarc",
        "dkim",
        "optionalPolicies",
        "posture",
        "findings",
        "provenance",
        "limitations",
        "checkedAt",
        "collectionMs"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.email-auth",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Domain intelligence (`web.domain-intelligence`)

Investigate a domain using parallel DNS, TLS certificate, RDAP, DNSSEC, SPF, and DMARC signals with factual findings and source provenance.

- Endpoint: `POST https://apiacre.com/v1/web/domain-intelligence`
- Exact price: `$0.02 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.domain-intelligence
- Browser checkout: https://apiacre.com/try/web.domain-intelligence
- Tags: web, audit, domain, dns, tls, rdap, dnssec, spf, dmarc, intelligence

#### Request example

```json
{
  "url": "https://apiacre.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "checkedAt": "2026-08-11T03:39:03+00:00",
    "collectionMs": 222,
    "dns": {
      "A": [
        "104.21.32.1",
        "172.67.128.1"
      ],
      "AAAA": [
        "2606:4700:3030::6815:2001",
        "2606:4700:3030::ac43:8001"
      ],
      "CAA": [],
      "MX": [
        "10 mail.protonmail.ch",
        "20 mailsec.protonmail.ch"
      ],
      "NS": [
        "autumn.ns.cloudflare.com",
        "bjorn.ns.cloudflare.com"
      ],
      "SOA": [
        "autumn.ns.cloudflare.com. dns.cloudflare.com. 2050154843 10000 2400 604800 1800"
      ],
      "TXT": [
        "v=spf1 include:_spf.protonmail.ch ~all"
      ]
    },
    "domain": "apiacre.com",
    "emailAuthentication": {
      "dkim": {
        "checked": false,
        "reason": "DKIM requires a selector; none was supplied."
      },
      "dmarc": {
        "configured": true,
        "policy": "quarantine",
        "records": [
          "v=DMARC1; p=quarantine"
        ],
        "subdomainPolicy": null
      },
      "mxConfigured": true,
      "nullMx": false,
      "spf": {
        "configured": true,
        "records": [
          "v=spf1 include:_spf.protonmail.ch ~all"
        ]
      }
    },
    "findings": [],
    "provenance": {
      "dns": {
        "source": "recursive DNS"
      },
      "rdap": {
        "source": "RDAP bootstrap",
        "url": "https://rdap.org/domain/apiacre.com"
      },
      "tls": {
        "port": 443,
        "source": "direct verified TLS handshake"
      }
    },
    "rdap": {
      "events": [
        {
          "action": "registration",
          "date": "2026-08-08T19:24:21Z"
        },
        {
          "action": "expiration",
          "date": "2027-08-08T19:24:21Z"
        }
      ],
      "handle": "3130220082_DOMAIN_COM-VRSN",
      "nameservers": [
        "autumn.ns.cloudflare.com",
        "bjorn.ns.cloudflare.com"
      ],
      "secureDns": {
        "delegationSigned": false,
        "dsDataCount": 0,
        "zoneSigned": null
      },
      "status": [
        "client transfer prohibited"
      ]
    },
    "requestedUrl": "https://apiacre.com/",
    "signals": {
      "addressResolved": true,
      "dmarcConfigured": true,
      "dnssecDelegationSigned": false,
      "mxConfigured": true,
      "rdapAvailable": true,
      "spfConfigured": true,
      "tlsAvailable": true
    },
    "tls": {
      "cipher": "TLS_AES_256_GCM_SHA384",
      "cipherBits": 256,
      "daysUntilExpiry": 87.7,
      "expired": false,
      "expires": "Nov  6 19:34:12 2026 GMT",
      "expiresAt": "2026-11-06T19:34:12+00:00",
      "issuer": {
        "commonName": "WE1",
        "country": "US",
        "organization": "Google Trust Services"
      },
      "subject": {
        "commonName": "apiacre.com"
      },
      "subjectAltNames": [
        "apiacre.com",
        "*.apiacre.com"
      ],
      "validFrom": "2026-08-08T18:34:13+00:00",
      "version": "TLSv1.3"
    }
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "dkim_selectors": [],
          "domain": "$result.data.domain"
        },
        "method": "POST",
        "path": "/v1/web/email-auth",
        "price": "$0.005",
        "reason": "Deepen the domain result with focused MX, SPF, DMARC, caller-selected DKIM, MTA-STS, TLS-RPT, and BIMI posture.",
        "service": "web.email-auth",
        "title": "Email authentication posture",
        "use_output": "Use the DNS-only posture and findings as time-specific configuration evidence; supply only DKIM selectors already known to the buyer."
      },
      {
        "authorization_required": true,
        "input_template": {
          "url": "$request.url"
        },
        "method": "POST",
        "path": "/v1/web/business-due-diligence",
        "price": "$0.1",
        "reason": "Combine domain signals with public-site quality checks in a business risk report.",
        "service": "web.business-due-diligence",
        "title": "Business domain due diligence",
        "use_output": "Review result.data.flags and riskLevel before relying on the domain."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.domain-intelligence",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Domain intelligence result",
      "properties": {
        "checkedAt": {
          "type": "string"
        },
        "collectionMs": {
          "type": "integer"
        },
        "dns": {
          "type": "object"
        },
        "domain": {
          "type": "string"
        },
        "emailAuthentication": {
          "type": "object"
        },
        "findings": {
          "items": {},
          "type": "array"
        },
        "provenance": {
          "type": "object"
        },
        "rdap": {
          "type": "object"
        },
        "requestedUrl": {
          "type": "string"
        },
        "signals": {
          "type": "object"
        },
        "tls": {
          "type": "object"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.domain-intelligence",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Full site audit (`web.full-audit`)

Run a comprehensive website audit combining SEO, security, accessibility, and performance scores with prioritized fixes.

- Endpoint: `POST https://apiacre.com/v1/web/full-audit`
- Exact price: `$0.25 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.full-audit
- Browser checkout: https://apiacre.com/try/web.full-audit
- Tags: web, audit, website, seo, security, accessibility, performance

#### Request example

```json
{
  "url": "https://example.com"
}
```

#### Input schema

```json
{
  "properties": {
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "UrlInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "accessibility": {},
    "overallScore": 1,
    "performance": {},
    "security": {},
    "seo": {}
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.full-audit",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Full site audit result",
      "properties": {
        "accessibility": {
          "type": "object"
        },
        "overallScore": {
          "type": "integer"
        },
        "performance": {
          "type": "object"
        },
        "security": {
          "type": "object"
        },
        "seo": {
          "type": "object"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.full-audit",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Business domain due diligence (`web.business-due-diligence`)

Assess a business domain using website quality, SEO, security, accessibility, performance, DNS, TLS, RDAP, and optional public GLEIF LEI entity candidates.

- Endpoint: `POST https://apiacre.com/v1/web/business-due-diligence`
- Exact price: `$0.1 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/web.business-due-diligence
- Browser checkout: https://apiacre.com/try/web.business-due-diligence
- Tags: web, audit, business, company, domain, due-diligence, risk, lei, legal-entity

#### Request example

```json
{
  "country_code": "US",
  "legal_name": "Apple Inc.",
  "url": "https://apple.com"
}
```

#### Input schema

```json
{
  "properties": {
    "country_code": {
      "anyOf": [
        {
          "pattern": "^[A-Za-z]{2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional ISO 3166-1 alpha-2 legal-address country filter",
      "examples": [
        "US"
      ],
      "title": "Country Code"
    },
    "legal_name": {
      "anyOf": [
        {
          "maxLength": 200,
          "minLength": 2,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional registered company name to match against public GLEIF LEI records. A match does not prove that the company owns the supplied domain.",
      "examples": [
        "Apple Inc."
      ],
      "title": "Legal Name"
    },
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "BusinessDueDiligenceInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "disclaimer": "The technical score and optional public LEI candidates do not prove domain ownership or identity.",
    "domain": "apple.com",
    "domainIntelligence": {
      "dns": {
        "A": [
          "17.253.144.10"
        ]
      },
      "domain": "apple.com",
      "rdap": {
        "status": [
          "active"
        ]
      },
      "tls": {
        "version": "TLSv1.3"
      }
    },
    "flags": [],
    "legalEntity": {
      "countryCode": "US",
      "license": {
        "id": "CC0-1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/"
      },
      "limitations": [
        "Candidates are matched from the supplied name and optional country only.",
        "A match does not prove that the entity owns or controls the supplied domain.",
        "Not every legal entity has an LEI, and source records may be stale or incomplete."
      ],
      "matchCount": 1,
      "matches": [
        {
          "category": "GENERAL",
          "conformityFlag": "CONFORMING",
          "creationDate": "1977-01-03T00:00:00Z",
          "entityStatus": "ACTIVE",
          "headquartersAddress": {
            "addressLines": [
              "One Apple Park Way"
            ],
            "city": "Cupertino",
            "country": "US",
            "postalCode": "95014",
            "region": "US-CA"
          },
          "jurisdiction": "US-CA",
          "legalAddress": {
            "country": "US",
            "region": "US-CA"
          },
          "legalName": "Apple Inc.",
          "lei": "HWUPKR0MPOU8FGXBT394",
          "match": {
            "score": 1.0,
            "type": "exact"
          },
          "otherNames": [
            {
              "language": "en",
              "name": "Apple Computer, Inc.",
              "type": "PREVIOUS_LEGAL_NAME"
            }
          ],
          "registeredAs": "806592",
          "registration": {
            "corroborationLevel": "FULLY_CORROBORATED",
            "lastUpdated": "2026-03-03T16:34:33Z",
            "nextRenewal": "2027-03-08T17:27:20Z",
            "status": "ISSUED"
          },
          "source": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394"
        }
      ],
      "requestedName": "Apple Inc.",
      "retrievedAt": "2026-08-11T00:00:00Z",
      "source": "https://api.gleif.org/api/v1/lei-records",
      "status": "matched",
      "warning": null
    },
    "riskLevel": "low",
    "riskScore": 84,
    "scoreScope": "website_and_domain_technical_signals",
    "siteAudit": {
      "accessibility": {
        "score": 92
      },
      "overallScore": 88,
      "performance": {
        "bytes": 1256,
        "elapsedMs": 146,
        "status": 200
      },
      "security": {
        "score": 83
      },
      "seo": {
        "score": 90
      }
    },
    "url": "https://www.apple.com/"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "web.business-due-diligence",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Business domain due diligence result",
      "properties": {
        "disclaimer": {
          "type": "string"
        },
        "domain": {
          "type": "string"
        },
        "domainIntelligence": {
          "type": "object"
        },
        "flags": {
          "items": {},
          "type": "array"
        },
        "legalEntity": {
          "type": "object"
        },
        "riskLevel": {
          "type": "string"
        },
        "riskScore": {
          "type": "integer"
        },
        "scoreScope": {
          "type": "string"
        },
        "siteAudit": {
          "type": "object"
        },
        "url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "web.business-due-diligence",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### GLEIF legal entity search (`research.lei-entity-search`)

Search the official GLEIF Global LEI Index by exact LEI or legal name and return ranked legal-entity identity, registration, mapped-identifier, and relationship-availability evidence.

- Endpoint: `POST https://apiacre.com/v1/research/lei-entity-search`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.lei-entity-search
- Browser checkout: https://apiacre.com/try/research.lei-entity-search
- Tags: research, company, legal-entity, lei, gleif, business-identity, kyb, official-data, registration, due-diligence

#### Request example

```json
{
  "country_code": "US",
  "legal_name": "Apple Inc.",
  "max_results": 3
}
```

#### Input schema

```json
{
  "properties": {
    "country_code": {
      "anyOf": [
        {
          "pattern": "^[A-Za-z]{2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional ISO 3166-1 alpha-2 legal-address country filter",
      "examples": [
        "US"
      ],
      "title": "Country Code"
    },
    "legal_name": {
      "anyOf": [
        {
          "maxLength": 200,
          "minLength": 2,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Registered or commonly used legal entity name",
      "examples": [
        "Apple Inc."
      ],
      "title": "Legal Name"
    },
    "lei": {
      "anyOf": [
        {
          "maxLength": 20,
          "minLength": 20,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Exact 20-character Legal Entity Identifier (LEI)",
      "examples": [
        "HWUPKR0MPOU8FGXBT394"
      ],
      "title": "Lei"
    },
    "max_results": {
      "default": 3,
      "description": "Maximum candidates returned for a name search",
      "maximum": 5,
      "minimum": 1,
      "title": "Max Results",
      "type": "integer"
    }
  },
  "title": "LegalEntitySearchInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "disclaimer": "Official public LEI reference data normalized from GLEIF. Corroborate name matches before KYC, credit, legal, compliance, or counterparty decisions.",
    "goldenCopyPublishedAt": "2026-08-11T00:00:00Z",
    "license": {
      "id": "CC0-1.0",
      "termsUrl": "https://www.gleif.org/en/meta/lei-data-terms-of-use/",
      "url": "https://creativecommons.org/publicdomain/zero/1.0/"
    },
    "limitations": [
      "Name-match scores rank candidates but do not establish identity.",
      "Not every legal entity has an LEI, and source records may be stale or incomplete.",
      "Relationship flags indicate available GLEIF links; they do not expand the relationship records."
    ],
    "matchCount": 1,
    "matches": [
      {
        "category": "GENERAL",
        "conformityFlag": "CONFORMING",
        "creationDate": "1977-01-03T00:00:00Z",
        "entityStatus": "ACTIVE",
        "headquartersAddress": {
          "addressLines": [
            "One Apple Park Way"
          ],
          "city": "Cupertino",
          "country": "US",
          "postalCode": "95014",
          "region": "US-CA"
        },
        "jurisdiction": "US-CA",
        "legalAddress": {
          "addressLines": [
            "C/O C T Corporation System",
            "330 N. Brand Blvd"
          ],
          "city": "Glendale",
          "country": "US",
          "postalCode": "91203",
          "region": "US-CA"
        },
        "legalForm": {
          "id": "H1UM",
          "other": null
        },
        "legalName": "Apple Inc.",
        "lei": "HWUPKR0MPOU8FGXBT394",
        "mappedIdentifiers": {
          "bic": [
            "APLEUS66XXX"
          ],
          "spGlobal": [
            "24937"
          ]
        },
        "match": {
          "score": 1.0,
          "type": "exact"
        },
        "otherNames": [
          {
            "language": "en",
            "name": "Apple Computer, Inc.",
            "type": "PREVIOUS_LEGAL_NAME"
          }
        ],
        "registeredAs": "806592",
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialDate": "2012-06-06T15:53:00Z",
          "lastUpdated": "2026-03-03T16:34:33Z",
          "nextRenewal": "2027-03-08T17:27:20Z",
          "status": "ISSUED",
          "validationAuthority": {
            "id": "RA000598",
            "other": null
          }
        },
        "registrationAuthority": {
          "id": "RA000598",
          "other": null
        },
        "relationshipsAvailable": {
          "directChildren": true,
          "directParent": false,
          "directParentException": true,
          "isins": true,
          "ultimateChildren": true,
          "ultimateParent": false,
          "ultimateParentException": true
        },
        "source": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394"
      }
    ],
    "query": {
      "countryCode": "US",
      "maxResults": 3,
      "mode": "legal_name",
      "value": "Apple Inc."
    },
    "retrievedAt": "2026-08-11T08:30:00+00:00",
    "source": "https://api.gleif.org/api/v1/lei-records",
    "status": "matched",
    "totalCandidates": 20
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "country_code": "$result.data.matches[0].legalAddress.country",
          "legal_name": "$result.data.matches[0].legalName"
        },
        "method": "POST",
        "path": "/v1/research/organization-evidence",
        "price": "$0.1",
        "reason": "Expand a selected GLEIF candidate with independent USAspending, SEC filing-activity, and OFAC Entity evidence in one separately authorized call.",
        "service": "research.organization-evidence",
        "title": "Official organization evidence bundle",
        "use_output": "Continue only after selecting the intended GLEIF candidate. Treat every source section independently; the bundle does not prove that records refer to the same organization."
      },
      {
        "authorization_required": true,
        "input_template": {
          "country_code": "$result.data.matches[0].legalAddress.country",
          "legal_name": "$result.data.matches[0].legalName",
          "url": "$companyDomainUrl"
        },
        "method": "POST",
        "path": "/v1/web/business-due-diligence",
        "price": "$0.1",
        "reason": "Combine a selected legal-entity candidate with public website, DNS, TLS, RDAP, and site-quality evidence.",
        "service": "web.business-due-diligence",
        "title": "Business domain due diligence",
        "use_output": "Continue only after selecting the correct candidate; the follow-up report does not prove that the entity controls the domain."
      },
      {
        "authorization_required": true,
        "input_template": {
          "entity_name": "$result.data.matches[0].legalName",
          "include_weak_aliases": false,
          "max_results": 5,
          "minimum_score": 85
        },
        "method": "POST",
        "path": "/v1/research/ofac-entity-search",
        "price": "$0.02",
        "reason": "Compare a selected official legal name with current OFAC Entity records and aliases.",
        "service": "research.ofac-entity-search",
        "title": "OFAC entity candidate evidence",
        "use_output": "Review returned candidates against the official record and program authority; no candidate is not compliance clearance."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.lei-entity-search",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured GLEIF legal entity search result",
      "properties": {
        "disclaimer": {
          "type": "string"
        },
        "goldenCopyPublishedAt": {
          "type": "string"
        },
        "license": {
          "type": "object"
        },
        "limitations": {
          "items": {},
          "type": "array"
        },
        "matchCount": {
          "type": "integer"
        },
        "matches": {
          "items": {},
          "type": "array"
        },
        "query": {
          "type": "object"
        },
        "retrievedAt": {
          "type": "string"
        },
        "source": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "totalCandidates": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.lei-entity-search",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Document extraction (`document.extract`)

Extract clean text and metadata from supplied PDF, DOCX, HTML, Markdown, CSV, JSON, YAML, or plain-text documents.

- Endpoint: `POST https://apiacre.com/v1/document/extract`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/document.extract
- Browser checkout: https://apiacre.com/try/document.extract
- Tags: documents, data, document, pdf, docx, text, extraction

#### Request example

```json
{
  "content_base64": "SGVsbG8gd29ybGQ=",
  "filename": "report.txt"
}
```

#### Input schema

```json
{
  "properties": {
    "content_base64": {
      "maxLength": 7100000,
      "title": "Content Base64",
      "type": "string"
    },
    "filename": {
      "maxLength": 240,
      "title": "Filename",
      "type": "string"
    }
  },
  "required": [
    "filename",
    "content_base64"
  ],
  "title": "DocumentInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "characters": 11,
    "metadata": {
      "bytes": 11,
      "filename": "report.txt",
      "sha256": "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c"
    },
    "text": "Hello world",
    "words": 2
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "text": "$result.data.text"
        },
        "method": "POST",
        "path": "/v1/document/redact",
        "price": "$0.01",
        "reason": "Remove common personal-data patterns from the extracted text before reuse.",
        "service": "document.redact",
        "title": "PII and personal-data redaction",
        "use_output": "Use result.data.text as the redacted document and inspect the returned counts."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "document.extract",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Document extraction result",
      "properties": {
        "characters": {
          "type": "integer"
        },
        "metadata": {
          "type": "object"
        },
        "text": {
          "type": "string"
        },
        "words": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "document.extract",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Table extraction (`document.tables`)

Extract structured table rows and columns from supplied HTML, DOCX, or CSV documents.

- Endpoint: `POST https://apiacre.com/v1/document/tables`
- Exact price: `$0.025 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/document.tables
- Browser checkout: https://apiacre.com/try/document.tables
- Tags: documents, data, document, table, csv, docx, extraction

#### Request example

```json
{
  "content_base64": "bmFtZSxzY29yZQpBZGEsOTg=",
  "filename": "report.csv"
}
```

#### Input schema

```json
{
  "properties": {
    "content_base64": {
      "maxLength": 7100000,
      "title": "Content Base64",
      "type": "string"
    },
    "filename": {
      "maxLength": 240,
      "title": "Filename",
      "type": "string"
    }
  },
  "required": [
    "filename",
    "content_base64"
  ],
  "title": "DocumentInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "metadata": {
      "bytes": 17,
      "filename": "report.csv",
      "sha256": "bae2475f86fa2343a9611424d3c2475e454b639c71da96a788602528e0937bea"
    },
    "rowCount": 2,
    "rows": [
      [
        "name",
        "score"
      ],
      [
        "Ada",
        "98"
      ]
    ],
    "warning": null
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "document.tables",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Table extraction result",
      "properties": {
        "metadata": {
          "type": "object"
        },
        "rowCount": {
          "type": "integer"
        },
        "rows": {
          "items": {},
          "type": "array"
        },
        "warning": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "document.tables",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### PII and personal-data redaction (`document.redact`)

Deterministically detect and redact PII and personal data in supplied text with overlap-safe matching for emails, phone numbers, validated IPv4 and IPv6 addresses, Luhn-valid payment cards, valid-checksum IBANs, and structurally valid US Social Security numbers.

- Endpoint: `POST https://apiacre.com/v1/document/redact`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/document.redact
- Browser checkout: https://apiacre.com/try/document.redact
- Tags: documents, data, pii, personal-data, redaction, sanitize, privacy, document, compliance, ipv6, iban, luhn

#### Request example

```json
{
  "text": "Contact analyst@example.com about invoice card 4242 4242 4242 4242."
}
```

#### Input schema

```json
{
  "properties": {
    "text": {
      "maxLength": 500000,
      "title": "Text",
      "type": "string"
    },
    "types": {
      "items": {
        "enum": [
          "email",
          "phone",
          "ipv4",
          "ipv6",
          "credit_card",
          "ssn",
          "iban"
        ],
        "type": "string"
      },
      "maxItems": 7,
      "minItems": 1,
      "title": "Types",
      "type": "array"
    }
  },
  "required": [
    "text"
  ],
  "title": "RedactInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "counts": {
      "credit_card": 1,
      "email": 1,
      "iban": 0,
      "ipv4": 0,
      "ipv6": 0,
      "phone": 0,
      "ssn": 0
    },
    "detector": {
      "deterministic": true,
      "networkRequestsMade": 0,
      "overlapSafe": true,
      "validatedTypes": [
        "credit_card",
        "iban",
        "ipv4",
        "ipv6",
        "ssn"
      ],
      "version": "apiacre-pii-redaction/2"
    },
    "findings": [
      {
        "characters": 19,
        "end": 27,
        "placeholder": "[REDACTED_EMAIL]",
        "start": 8,
        "type": "email"
      },
      {
        "characters": 19,
        "end": 66,
        "placeholder": "[REDACTED_CREDIT_CARD]",
        "start": 47,
        "type": "credit_card"
      }
    ],
    "findingsReturned": 2,
    "findingsTruncated": false,
    "inputSha256": "04b4432fceb85a844f4a83b4ddabd14dda672c9c94b8c54c020ff06de182d2f6",
    "limitations": [
      "Deterministic patterns do not identify names, street addresses, or every locale-specific identifier.",
      "Review redacted output before treating it as safe for a particular privacy or compliance policy."
    ],
    "outputSha256": "7e30afcfe691fb4e6527ee782aaa6cccd68b726687540cb2d6de557cfe921c13",
    "redactedCharacters": 38,
    "selectedTypes": [
      "email",
      "phone",
      "ipv4",
      "ipv6",
      "credit_card",
      "ssn",
      "iban"
    ],
    "text": "Contact [REDACTED_EMAIL] about invoice card [REDACTED_CREDIT_CARD].",
    "total": 2
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "document.redact",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured PII and personal-data redaction result",
      "properties": {
        "counts": {
          "additionalProperties": false,
          "properties": {
            "credit_card": {
              "maximum": 500000,
              "minimum": 0,
              "type": "integer"
            },
            "email": {
              "maximum": 500000,
              "minimum": 0,
              "type": "integer"
            },
            "iban": {
              "maximum": 500000,
              "minimum": 0,
              "type": "integer"
            },
            "ipv4": {
              "maximum": 500000,
              "minimum": 0,
              "type": "integer"
            },
            "ipv6": {
              "maximum": 500000,
              "minimum": 0,
              "type": "integer"
            },
            "phone": {
              "maximum": 500000,
              "minimum": 0,
              "type": "integer"
            },
            "ssn": {
              "maximum": 500000,
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "email",
            "phone",
            "ipv4",
            "ipv6",
            "credit_card",
            "ssn",
            "iban"
          ],
          "type": "object"
        },
        "detector": {
          "additionalProperties": false,
          "properties": {
            "deterministic": {
              "const": true,
              "type": "boolean"
            },
            "networkRequestsMade": {
              "const": 0,
              "type": "integer"
            },
            "overlapSafe": {
              "const": true,
              "type": "boolean"
            },
            "validatedTypes": {
              "const": [
                "credit_card",
                "iban",
                "ipv4",
                "ipv6",
                "ssn"
              ],
              "type": "array"
            },
            "version": {
              "const": "apiacre-pii-redaction/2",
              "type": "string"
            }
          },
          "required": [
            "version",
            "deterministic",
            "overlapSafe",
            "validatedTypes",
            "networkRequestsMade"
          ],
          "type": "object"
        },
        "findings": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "characters": {
                "maximum": 500000,
                "minimum": 1,
                "type": "integer"
              },
              "end": {
                "maximum": 500000,
                "minimum": 1,
                "type": "integer"
              },
              "placeholder": {
                "enum": [
                  "[REDACTED_EMAIL]",
                  "[REDACTED_PHONE]",
                  "[REDACTED_IPV4]",
                  "[REDACTED_IPV6]",
                  "[REDACTED_CREDIT_CARD]",
                  "[REDACTED_SSN]",
                  "[REDACTED_IBAN]"
                ],
                "type": "string"
              },
              "start": {
                "maximum": 500000,
                "minimum": 0,
                "type": "integer"
              },
              "type": {
                "enum": [
                  "email",
                  "phone",
                  "ipv4",
                  "ipv6",
                  "credit_card",
                  "ssn",
                  "iban"
                ],
                "type": "string"
              }
            },
            "required": [
              "type",
              "start",
              "end",
              "characters",
              "placeholder"
            ],
            "type": "object"
          },
          "maxItems": 1000,
          "type": "array"
        },
        "findingsReturned": {
          "maximum": 1000,
          "minimum": 0,
          "type": "integer"
        },
        "findingsTruncated": {
          "type": "boolean"
        },
        "inputSha256": {
          "pattern": "^[0-9a-f]{64}$",
          "type": "string"
        },
        "limitations": {
          "items": {
            "maxLength": 500,
            "type": "string"
          },
          "maxItems": 2,
          "minItems": 2,
          "type": "array"
        },
        "outputSha256": {
          "pattern": "^[0-9a-f]{64}$",
          "type": "string"
        },
        "redactedCharacters": {
          "maximum": 500000,
          "minimum": 0,
          "type": "integer"
        },
        "selectedTypes": {
          "items": {
            "enum": [
              "email",
              "phone",
              "ipv4",
              "ipv6",
              "credit_card",
              "ssn",
              "iban"
            ],
            "type": "string"
          },
          "maxItems": 7,
          "minItems": 1,
          "type": "array",
          "uniqueItems": true
        },
        "text": {
          "maxLength": 3000000,
          "type": "string"
        },
        "total": {
          "maximum": 500000,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "text",
        "counts",
        "total",
        "selectedTypes",
        "findingsReturned",
        "findingsTruncated",
        "findings",
        "redactedCharacters",
        "inputSha256",
        "outputSha256",
        "detector",
        "limitations"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "document.redact",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Document diff (`document.diff`)

Compare two texts and return structured line additions, removals, and a unified diff.

- Endpoint: `POST https://apiacre.com/v1/document/diff`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/document.diff
- Browser checkout: https://apiacre.com/try/document.diff
- Tags: documents, data, document, diff, compare, text

#### Request example

```json
{
  "after": "status: approved",
  "before": "status: draft"
}
```

#### Input schema

```json
{
  "properties": {
    "after": {
      "maxLength": 500000,
      "title": "After",
      "type": "string"
    },
    "before": {
      "maxLength": 500000,
      "title": "Before",
      "type": "string"
    },
    "context_lines": {
      "default": 3,
      "maximum": 20,
      "minimum": 0,
      "title": "Context Lines",
      "type": "integer"
    }
  },
  "required": [
    "before",
    "after"
  ],
  "title": "DiffInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "added": 1,
    "changed": true,
    "diff": "example",
    "removed": 1
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "document.diff",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Document diff result",
      "properties": {
        "added": {
          "type": "integer"
        },
        "changed": {
          "type": "boolean"
        },
        "diff": {
          "type": "string"
        },
        "removed": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "document.diff",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Dataset profile (`data.profile`)

Profile CSV, JSON, or YAML records for field types, nulls, uniqueness, and representative samples.

- Endpoint: `POST https://apiacre.com/v1/data/profile`
- Exact price: `$0.025 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.profile
- Browser checkout: https://apiacre.com/try/data.profile
- Tags: documents, data, profiling, csv, json, quality

#### Request example

```json
{
  "content": "name,score\nAda,98\nLin,91",
  "format": "csv"
}
```

#### Input schema

```json
{
  "properties": {
    "content": {
      "maxLength": 2000000,
      "title": "Content",
      "type": "string"
    },
    "format": {
      "enum": [
        "csv",
        "json",
        "yaml"
      ],
      "title": "Format",
      "type": "string"
    }
  },
  "required": [
    "content",
    "format"
  ],
  "title": "DataInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "columns": 2,
    "profile": {
      "name": {
        "nonNull": 2,
        "null": 0,
        "samples": [
          "Ada",
          "Lin"
        ],
        "types": {
          "str": 2
        },
        "unique": 2
      },
      "score": {
        "nonNull": 2,
        "null": 0,
        "samples": [
          "98",
          "91"
        ],
        "types": {
          "str": 2
        },
        "unique": 2
      }
    },
    "rows": 2
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "content": "$request.content",
          "format": "$request.format"
        },
        "method": "POST",
        "path": "/v1/data/schema",
        "price": "$0.025",
        "reason": "Infer a reusable JSON Schema after profiling the source records.",
        "service": "data.schema",
        "title": "Schema inference",
        "use_output": "Persist result.data.schema as the validation contract for future records."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.profile",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Dataset profile result",
      "properties": {
        "columns": {
          "type": "integer"
        },
        "profile": {
          "type": "object"
        },
        "rows": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.profile",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Dataset cleaning (`data.clean`)

Clean CSV, JSON, or YAML records by normalizing keys, trimming whitespace, and standardizing empty values.

- Endpoint: `POST https://apiacre.com/v1/data/clean`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.clean
- Browser checkout: https://apiacre.com/try/data.clean
- Tags: documents, data, cleaning, csv, json, normalize

#### Request example

```json
{
  "content": "name,score\n Ada ,98",
  "format": "csv"
}
```

#### Input schema

```json
{
  "properties": {
    "content": {
      "maxLength": 2000000,
      "title": "Content",
      "type": "string"
    },
    "empty_to_null": {
      "default": true,
      "title": "Empty To Null",
      "type": "boolean"
    },
    "format": {
      "enum": [
        "csv",
        "json",
        "yaml"
      ],
      "title": "Format",
      "type": "string"
    },
    "normalize_headers": {
      "default": true,
      "title": "Normalize Headers",
      "type": "boolean"
    },
    "trim_strings": {
      "default": true,
      "title": "Trim Strings",
      "type": "boolean"
    }
  },
  "required": [
    "content",
    "format"
  ],
  "title": "CleanInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "records": [
      {
        "name": "Ada",
        "score": "98"
      }
    ],
    "rows": 1
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.clean",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Dataset cleaning result",
      "properties": {
        "records": {
          "items": {},
          "type": "array"
        },
        "rows": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.clean",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Data conversion (`data.convert`)

Convert structured data between CSV, JSON, and YAML formats with a machine-readable response.

- Endpoint: `POST https://apiacre.com/v1/data/convert`
- Exact price: `$0.005 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.convert
- Browser checkout: https://apiacre.com/try/data.convert
- Tags: documents, data, convert, csv, json, yaml

#### Request example

```json
{
  "content": "name,score\nAda,98",
  "format": "csv",
  "target_format": "json"
}
```

#### Input schema

```json
{
  "properties": {
    "content": {
      "maxLength": 2000000,
      "title": "Content",
      "type": "string"
    },
    "format": {
      "enum": [
        "csv",
        "json",
        "yaml"
      ],
      "title": "Format",
      "type": "string"
    },
    "target_format": {
      "enum": [
        "csv",
        "json",
        "yaml"
      ],
      "title": "Target Format",
      "type": "string"
    }
  },
  "required": [
    "content",
    "format",
    "target_format"
  ],
  "title": "ConvertInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "content": "[\n  {\n    \"name\": \"Ada\",\n    \"score\": \"98\"\n  }\n]",
    "format": "json",
    "rows": 1
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.convert",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Data conversion result",
      "properties": {
        "content": {
          "type": "string"
        },
        "format": {
          "type": "string"
        },
        "rows": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.convert",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Schema inference (`data.schema`)

Infer a nested JSON Schema Draft 2020-12 contract from CSV, JSON, or YAML, including required fields, mixed and nullable types, array items, object properties, input evidence, and non-enforcing observed bounds.

- Endpoint: `POST https://apiacre.com/v1/data/schema`
- Exact price: `$0.025 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.schema
- Browser checkout: https://apiacre.com/try/data.schema
- Tags: documents, data, schema, json-schema, inference, nested, validation, csv, yaml

#### Request example

```json
{
  "content": "[{\"name\":\"Ada\",\"score\":98}]",
  "format": "json",
  "root_mode": "records"
}
```

#### Input schema

```json
{
  "properties": {
    "content": {
      "maxLength": 2000000,
      "title": "Content",
      "type": "string"
    },
    "format": {
      "enum": [
        "csv",
        "json",
        "yaml"
      ],
      "title": "Format",
      "type": "string"
    },
    "root_mode": {
      "default": "records",
      "description": "Keep the compatible array-of-records contract, or preserve the JSON/YAML root shape",
      "enum": [
        "records",
        "preserve"
      ],
      "title": "Root Mode",
      "type": "string"
    }
  },
  "required": [
    "content",
    "format"
  ],
  "title": "SchemaInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "inference": {
      "complete": true,
      "csvEmptyStringsAsNull": false,
      "csvNumericStringsCoerced": false,
      "dialect": "https://json-schema.org/draft/2020-12/schema",
      "maximumDepth": 20,
      "observedBoundsEnforced": false,
      "version": "apiacre-schema-inference/2",
      "warnings": []
    },
    "input": {
      "characters": 27,
      "format": "json",
      "records": 1,
      "rootMode": "records",
      "sha256": "c643e5c255c8922bcd1163746ad6233618735d05482f8d2fa68e30021648f076",
      "utf8Bytes": 27
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "items": {
        "properties": {
          "name": {
            "type": "string",
            "x-apiacre-observed": {
              "missingCount": 0,
              "nullCount": 0,
              "presentCount": 1,
              "sampleCount": 1,
              "stringLength": {
                "maximum": 3,
                "minimum": 3
              },
              "types": [
                "string"
              ]
            }
          },
          "score": {
            "type": "integer",
            "x-apiacre-observed": {
              "missingCount": 0,
              "nullCount": 0,
              "presentCount": 1,
              "sampleCount": 1,
              "types": [
                "integer"
              ]
            }
          }
        },
        "required": [
          "name",
          "score"
        ],
        "type": "object",
        "x-apiacre-observed": {
          "missingCount": 0,
          "nullCount": 0,
          "presentCount": 1,
          "sampleCount": 1,
          "types": [
            "object"
          ]
        }
      },
      "type": "array",
      "x-apiacre-observed": {
        "arrayLength": {
          "maximum": 1,
          "minimum": 1
        },
        "missingCount": 0,
        "nullCount": 0,
        "presentCount": 1,
        "sampleCount": 1,
        "types": [
          "array"
        ]
      }
    }
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "check_formats": true,
          "instance": "$futureJsonValue",
          "max_errors": 25,
          "schema": "$result.data.schema"
        },
        "method": "POST",
        "path": "/v1/data/schema-validate",
        "price": "$0.01",
        "reason": "Validate a future JSON value against the inferred Draft 2020-12 contract.",
        "service": "data.schema-validate",
        "title": "JSON Schema validation",
        "use_output": "Require result.data.valid and inspect JSON Pointer errors before accepting the value."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.schema",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Schema inference result",
      "properties": {
        "inference": {
          "type": "object"
        },
        "input": {
          "type": "object"
        },
        "schema": {
          "type": "object"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.schema",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### JSON Schema validation (`data.schema-validate`)

Validate caller-supplied JSON against a bounded JSON Schema Draft 2020-12 contract with deterministic error pointers, format checks, input fingerprints, and no remote reference resolution.

- Endpoint: `POST https://apiacre.com/v1/data/schema-validate`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.schema-validate
- Browser checkout: https://apiacre.com/try/data.schema-validate
- Tags: documents, data, schema, json-schema, validation, draft-2020-12, contract, quality, deterministic

#### Request example

```json
{
  "check_formats": true,
  "instance": {
    "name": "Ada",
    "score": "98"
  },
  "max_errors": 25,
  "schema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "name": {
        "minLength": 1,
        "type": "string"
      },
      "score": {
        "minimum": 0,
        "type": "integer"
      }
    },
    "required": [
      "name",
      "score"
    ],
    "type": "object"
  }
}
```

#### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "check_formats": {
      "default": true,
      "description": "Assert supported JSON Schema formats as well as structural keywords",
      "title": "Check Formats",
      "type": "boolean"
    },
    "instance": {
      "description": "JSON-compatible value to validate",
      "title": "Instance"
    },
    "max_errors": {
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "title": "Max Errors",
      "type": "integer"
    },
    "schema": {
      "additionalProperties": true,
      "description": "JSON Schema Draft 2020-12 document; only local fragment references are allowed",
      "title": "Schema",
      "type": "object"
    }
  },
  "required": [
    "schema",
    "instance"
  ],
  "title": "SchemaValidateInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "errorCount": 1,
    "errorCountExact": true,
    "errors": [
      {
        "instancePath": "/score",
        "keyword": "type",
        "kind": "instance",
        "message": "'98' is not of type 'integer'",
        "schemaPath": "/properties/score/type"
      }
    ],
    "errorsReturned": 1,
    "errorsTruncated": false,
    "instance": {
      "sha256": "43d117eb76b608a0d05820c70320889a6577ff85446e00412b6e6487c1559149",
      "utf8Bytes": 27
    },
    "instanceValid": false,
    "schema": {
      "declaredDialect": "https://json-schema.org/draft/2020-12/schema",
      "dialect": "https://json-schema.org/draft/2020-12/schema",
      "remoteReferencesAllowed": false,
      "sha256": "9565a3dfc9aaadfaf2b3163f433b954d7d91246b6c225c11a8c16fe42ae841e4",
      "utf8Bytes": 224
    },
    "schemaValid": true,
    "valid": false,
    "validation": {
      "draft": "2020-12",
      "engine": "python-jsonschema",
      "engineVersion": "4.26.0",
      "formatChecking": true,
      "maxErrors": 25,
      "networkRequestsMade": false
    }
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.schema-validate",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured JSON Schema validation result",
      "properties": {
        "errorCount": {
          "maximum": 101,
          "minimum": 0,
          "type": "integer"
        },
        "errorCountExact": {
          "type": "boolean"
        },
        "errors": {
          "items": {
            "properties": {
              "instancePath": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "keyword": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "kind": {
                "enum": [
                  "schema",
                  "instance"
                ],
                "type": "string"
              },
              "message": {
                "maxLength": 500,
                "type": "string"
              },
              "schemaPath": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "instancePath",
              "schemaPath",
              "keyword",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 100,
          "type": "array"
        },
        "errorsReturned": {
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "errorsTruncated": {
          "type": "boolean"
        },
        "instance": {
          "properties": {
            "sha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "utf8Bytes": {
              "maximum": 1000000,
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "utf8Bytes",
            "sha256"
          ],
          "type": "object"
        },
        "instanceValid": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "schema": {
          "properties": {
            "declaredDialect": {
              "type": [
                "string",
                "null"
              ]
            },
            "dialect": {
              "const": "https://json-schema.org/draft/2020-12/schema",
              "type": "string"
            },
            "remoteReferencesAllowed": {
              "const": false,
              "type": "boolean"
            },
            "sha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "utf8Bytes": {
              "maximum": 500000,
              "minimum": 2,
              "type": "integer"
            }
          },
          "required": [
            "dialect",
            "declaredDialect",
            "utf8Bytes",
            "sha256",
            "remoteReferencesAllowed"
          ],
          "type": "object"
        },
        "schemaValid": {
          "type": "boolean"
        },
        "valid": {
          "type": "boolean"
        },
        "validation": {
          "properties": {
            "draft": {
              "const": "2020-12",
              "type": "string"
            },
            "engine": {
              "const": "python-jsonschema",
              "type": "string"
            },
            "engineVersion": {
              "type": "string"
            },
            "formatChecking": {
              "type": "boolean"
            },
            "maxErrors": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            },
            "networkRequestsMade": {
              "const": false,
              "type": "boolean"
            }
          },
          "required": [
            "engine",
            "engineVersion",
            "draft",
            "formatChecking",
            "maxErrors",
            "networkRequestsMade"
          ],
          "type": "object"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.schema-validate",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Schema.org JSON-LD normalization (`data.schemaorg-normalize`)

Normalize caller-supplied inline Schema.org JSON-LD into deterministic Organization, Product, Service, Article, and Event entities with privacy scrubbing and field-level evidence hashes.

- Endpoint: `POST https://apiacre.com/v1/data/schemaorg-normalize`
- Exact price: `$0.02 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.schemaorg-normalize
- Browser checkout: https://apiacre.com/try/data.schemaorg-normalize
- Tags: documents, data, schema.org, json-ld, structured-data, normalize, ecommerce, enrichment

#### Request example

```json
{
  "base_url": "https://merchant.example/catalog/",
  "html": "<script type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"Product\",\"@id\":\"/products/acre-audit\",\"name\":\"Acre Audit\",\"sku\":\"ACRE-1\",\"offers\":{\"price\":\"19.00\",\"priceCurrency\":\"USD\"}}</script>",
  "include_types": [
    "Organization",
    "Product",
    "Service",
    "Article",
    "Event"
  ]
}
```

#### Input schema

```json
{
  "properties": {
    "base_url": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Base Url"
    },
    "html": {
      "maxLength": 500000,
      "minLength": 1,
      "title": "Html",
      "type": "string"
    },
    "include_types": {
      "items": {
        "enum": [
          "Organization",
          "Product",
          "Service",
          "Article",
          "Event"
        ],
        "type": "string"
      },
      "maxItems": 5,
      "minItems": 1,
      "title": "Include Types",
      "type": "array"
    }
  },
  "required": [
    "html"
  ],
  "title": "SchemaOrgNormalizeInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "conflicts": [],
    "documentSha256": "d81765f451d9a26a0f3d57a2a54f93814e69e74619b833e6ab1ca7c054aa3eb2",
    "nodes": [
      {
        "evidence": [
          {
            "blockIndex": 0,
            "field": "name",
            "jsonPointer": "/name",
            "valueSha256": "ae1a7c0779ad2136ec1fb0b0d4fc41b3b2b4725705a0be16db9e6131a1259678"
          },
          {
            "blockIndex": 0,
            "field": "offers",
            "jsonPointer": "/offers",
            "valueSha256": "60039362af5350d5de23be1025c7f55026c58049badb772ae937402886cbec4c"
          },
          {
            "blockIndex": 0,
            "field": "sku",
            "jsonPointer": "/sku",
            "valueSha256": "55f1dc0f11886752410eb312ae276382a6c8ae8d785f9f997a70f417f615fd46"
          }
        ],
        "fields": {
          "name": "Acre Audit",
          "offers": [
            {
              "price": "19.00",
              "priceCurrency": "USD"
            }
          ],
          "sku": "ACRE-1"
        },
        "id": "https://merchant.example/products/acre-audit",
        "type": "Product"
      }
    ],
    "nodesReturned": 1,
    "nodesSeen": 1,
    "scriptsSeen": 1,
    "typeCounts": {
      "Product": 1
    },
    "vocabulary": {
      "license": "CC BY-SA 3.0",
      "licenseUrl": "https://creativecommons.org/licenses/by-sa/3.0/",
      "name": "Schema.org",
      "url": "https://schema.org/"
    },
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.schemaorg-normalize",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Schema.org JSON-LD normalization result",
      "properties": {
        "conflicts": {
          "items": {},
          "type": "array"
        },
        "documentSha256": {
          "type": "string"
        },
        "nodes": {
          "items": {},
          "type": "array"
        },
        "nodesReturned": {
          "type": "integer"
        },
        "nodesSeen": {
          "type": "integer"
        },
        "scriptsSeen": {
          "type": "integer"
        },
        "typeCounts": {
          "type": "object"
        },
        "vocabulary": {
          "type": "object"
        },
        "warnings": {
          "items": {},
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.schemaorg-normalize",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Record deduplication (`data.deduplicate`)

Remove duplicate CSV, JSON, or YAML records using selected identity fields and report the removed count.

- Endpoint: `POST https://apiacre.com/v1/data/deduplicate`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.deduplicate
- Browser checkout: https://apiacre.com/try/data.deduplicate
- Tags: documents, data, deduplicate, cleaning, records

#### Request example

```json
{
  "content": "id,name\n1,Ada\n1,Ada",
  "format": "csv",
  "keys": [
    "id"
  ]
}
```

#### Input schema

```json
{
  "properties": {
    "content": {
      "maxLength": 2000000,
      "title": "Content",
      "type": "string"
    },
    "format": {
      "enum": [
        "csv",
        "json",
        "yaml"
      ],
      "title": "Format",
      "type": "string"
    },
    "keep": {
      "default": "first",
      "enum": [
        "first",
        "last"
      ],
      "title": "Keep",
      "type": "string"
    },
    "keys": {
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "title": "Keys",
      "type": "array"
    }
  },
  "required": [
    "content",
    "format"
  ],
  "title": "DedupeInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "inputRows": 2,
    "keys": [
      "id"
    ],
    "outputRows": 1,
    "records": [
      {
        "id": "1",
        "name": "Ada"
      }
    ],
    "removed": 1
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.deduplicate",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Record deduplication result",
      "properties": {
        "inputRows": {
          "type": "integer"
        },
        "keys": {
          "items": {},
          "type": "array"
        },
        "outputRows": {
          "type": "integer"
        },
        "records": {
          "items": {},
          "type": "array"
        },
        "removed": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.deduplicate",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### x402 endpoint preflight (`developer.x402-preflight`)

Probe a public endpoint without paying and return an x402 v2 compliance grade, protocol evidence, and actionable remediation.

- Endpoint: `POST https://apiacre.com/v1/developer/x402-preflight`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.x402-preflight
- Browser checkout: https://apiacre.com/try/developer.x402-preflight
- Tags: developer, research, x402, payment, preflight, compliance, bazaar

#### Request example

```json
{
  "body": {
    "document": "{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\",\"version\":\"1\"},\"paths\":{}}",
    "format": "json"
  },
  "method": "POST",
  "url": "https://apiacre.com/v1/developer/openapi-audit"
}
```

#### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    },
    "method": {
      "default": "POST",
      "enum": [
        "GET",
        "POST"
      ],
      "title": "Method",
      "type": "string"
    },
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "X402PreflightInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "checkedAt": "2026-08-09T00:00:00+00:00",
    "checks": [
      {
        "id": "http_402",
        "message": "Return HTTP 402 before payment.",
        "passed": true,
        "severity": "high"
      },
      {
        "id": "header_decodes",
        "message": "PAYMENT-REQUIRED decodes to a JSON object.",
        "passed": true,
        "severity": "high"
      },
      {
        "id": "x402_v2",
        "message": "Set x402Version to the integer 2.",
        "passed": true,
        "severity": "high"
      },
      {
        "id": "caip2_network",
        "message": "Use a valid CAIP-2 network identifier.",
        "passed": true,
        "severity": "high"
      },
      {
        "id": "resource_binding",
        "message": "Bind resource.url to the endpoint that returned the payment requirement.",
        "passed": true,
        "severity": "medium"
      }
    ],
    "compliant": true,
    "elapsedMs": 128,
    "finalUrl": "https://apiacre.com/v1/developer/openapi-audit",
    "grade": "A",
    "gradeVersion": "apiacre-x402-preflight/1",
    "limitations": "One unpaid request only; no payment is signed and the target response is not retained.",
    "method": "POST",
    "payment": {
      "acceptsCount": 1,
      "amount": "50000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "network": "eip155:8453",
      "payTo": "0xa0BFa4f07281c9b248DC3AED2217836BcA24869B",
      "scheme": "exact",
      "version": 2
    },
    "remediation": [],
    "score": 100,
    "statusCode": 402,
    "url": "https://apiacre.com/v1/developer/openapi-audit"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.x402-preflight",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured x402 endpoint preflight result",
      "properties": {
        "checkedAt": {
          "type": "string"
        },
        "checks": {
          "items": {},
          "type": "array"
        },
        "compliant": {
          "type": "boolean"
        },
        "elapsedMs": {
          "type": "integer"
        },
        "finalUrl": {
          "type": "string"
        },
        "grade": {
          "type": "string"
        },
        "gradeVersion": {
          "type": "string"
        },
        "limitations": {
          "type": "string"
        },
        "method": {
          "type": "string"
        },
        "payment": {
          "type": "object"
        },
        "remediation": {
          "items": {},
          "type": "array"
        },
        "score": {
          "type": "integer"
        },
        "statusCode": {
          "type": "integer"
        },
        "url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.x402-preflight",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### OpenAPI audit (`developer.openapi-audit`)

Validate and audit an OpenAPI document for missing operation IDs, descriptions, responses, and consistency problems.

- Endpoint: `POST https://apiacre.com/v1/developer/openapi-audit`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.openapi-audit
- Browser checkout: https://apiacre.com/try/developer.openapi-audit
- Tags: developer, research, openapi, api, lint, audit

#### Request example

```json
{
  "document": "{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\",\"version\":\"1.0\"},\"paths\":{}}",
  "format": "json"
}
```

#### Input schema

```json
{
  "properties": {
    "document": {
      "maxLength": 2000000,
      "title": "Document",
      "type": "string"
    },
    "format": {
      "default": "yaml",
      "enum": [
        "json",
        "yaml"
      ],
      "title": "Format",
      "type": "string"
    }
  },
  "required": [
    "document"
  ],
  "title": "StructuredDocumentInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "issues": [
      {
        "code": "missing_paths",
        "message": "No API paths are defined",
        "severity": "high"
      }
    ],
    "operations": 0,
    "score": 80,
    "valid": false
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "document": "$request.document",
          "format": "$request.format",
          "include_optional": false,
          "max_operations": 25,
          "timeout_seconds": 20
        },
        "method": "POST",
        "path": "/v1/developer/openapi-test-generate",
        "price": "$0.1",
        "reason": "Generate syntax-validated pytest smoke tests from the audited OpenAPI document.",
        "service": "developer.openapi-test-generate",
        "title": "OpenAPI pytest generator",
        "use_output": "Review result.data.source before running the generated tests against a target API."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.openapi-audit",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured OpenAPI audit result",
      "properties": {
        "issues": {
          "items": {},
          "type": "array"
        },
        "operations": {
          "type": "integer"
        },
        "score": {
          "type": "integer"
        },
        "valid": {
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.openapi-audit",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Audit Python and npm dependencies for vulnerabilities (`developer.dependency-audit`)

Audit exact Python/PyPI, npm, Go, Maven, NuGet, crates.io, or RubyGems dependencies against OSV and return affected packages and vulnerabilities.

- Endpoint: `POST https://apiacre.com/v1/developer/dependency-audit`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.dependency-audit
- Browser checkout: https://apiacre.com/try/developer.dependency-audit
- Tags: developer, research, dependency-audit, dependencies, python, pypi, npm, packages, osv, vulnerability, security, supply-chain

#### Request example

```json
{
  "dependencies": [
    {
      "name": "requests",
      "version": "2.32.3"
    }
  ],
  "ecosystem": "PyPI"
}
```

#### Input schema

```json
{
  "$defs": {
    "Dependency": {
      "properties": {
        "name": {
          "maxLength": 240,
          "minLength": 1,
          "title": "Name",
          "type": "string"
        },
        "version": {
          "maxLength": 120,
          "minLength": 1,
          "title": "Version",
          "type": "string"
        }
      },
      "required": [
        "name",
        "version"
      ],
      "title": "Dependency",
      "type": "object"
    }
  },
  "properties": {
    "dependencies": {
      "items": {
        "$ref": "#/$defs/Dependency"
      },
      "maxItems": 100,
      "minItems": 1,
      "title": "Dependencies",
      "type": "array"
    },
    "ecosystem": {
      "enum": [
        "PyPI",
        "npm",
        "Go",
        "Maven",
        "NuGet",
        "crates.io",
        "RubyGems"
      ],
      "title": "Ecosystem",
      "type": "string"
    }
  },
  "required": [
    "ecosystem",
    "dependencies"
  ],
  "title": "DependencyAuditInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "clean": true,
    "dependencies": [],
    "ecosystem": "example",
    "findings": [],
    "source": "example",
    "vulnerabilityCount": 1
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.dependency-audit",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Audit Python and npm dependencies for vulnerabilities result",
      "properties": {
        "clean": {
          "type": "boolean"
        },
        "dependencies": {
          "items": {},
          "type": "array"
        },
        "ecosystem": {
          "type": "string"
        },
        "findings": {
          "items": {},
          "type": "array"
        },
        "source": {
          "type": "string"
        },
        "vulnerabilityCount": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.dependency-audit",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### License compatibility audit (`developer.license-audit`)

Classify software dependency licenses and flag packages that need commercial or legal review.

- Endpoint: `POST https://apiacre.com/v1/developer/license-audit`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.license-audit
- Browser checkout: https://apiacre.com/try/developer.license-audit
- Tags: developer, research, dependencies, license, compliance

#### Request example

```json
{
  "dependencies": [
    {
      "license": "Apache-2.0",
      "name": "requests"
    }
  ]
}
```

#### Input schema

```json
{
  "$defs": {
    "LicensedDependency": {
      "properties": {
        "license": {
          "maxLength": 120,
          "minLength": 1,
          "title": "License",
          "type": "string"
        },
        "name": {
          "maxLength": 240,
          "minLength": 1,
          "title": "Name",
          "type": "string"
        }
      },
      "required": [
        "name",
        "license"
      ],
      "title": "LicensedDependency",
      "type": "object"
    }
  },
  "properties": {
    "dependencies": {
      "items": {
        "$ref": "#/$defs/LicensedDependency"
      },
      "maxItems": 500,
      "minItems": 1,
      "title": "Dependencies",
      "type": "array"
    },
    "policy": {
      "default": "commercial",
      "enum": [
        "permissive",
        "commercial"
      ],
      "title": "Policy",
      "type": "string"
    }
  },
  "required": [
    "dependencies"
  ],
  "title": "LicenseAuditInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "counts": {},
    "disclaimer": "example",
    "findings": [],
    "policy": "example",
    "requiresReview": true
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.license-audit",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured License compatibility audit result",
      "properties": {
        "counts": {
          "type": "object"
        },
        "disclaimer": {
          "type": "string"
        },
        "findings": {
          "items": {},
          "type": "array"
        },
        "policy": {
          "type": "string"
        },
        "requiresReview": {
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.license-audit",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Secret scan (`developer.secret-scan`)

Scan source code or configuration text for leaked API keys, tokens, and credentials without returning secret values.

- Endpoint: `POST https://apiacre.com/v1/developer/secret-scan`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.secret-scan
- Browser checkout: https://apiacre.com/try/developer.secret-scan
- Tags: developer, research, secret, credentials, security, source-code, scan

#### Request example

```json
{
  "content": "API_TOKEN=replace-with-your-token"
}
```

#### Input schema

```json
{
  "properties": {
    "content": {
      "maxLength": 2000000,
      "title": "Content",
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "title": "SecretScanInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "clean": true,
    "findingCount": 1,
    "findings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.secret-scan",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Secret scan result",
      "properties": {
        "clean": {
          "type": "boolean"
        },
        "findingCount": {
          "type": "integer"
        },
        "findings": {
          "items": {},
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.secret-scan",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Code metrics (`developer.code-metrics`)

Measure caller-supplied source code with Python AST analysis or a deterministic lexical fallback, including per-function complexity, a SHA-256 fingerprint, density ratios, syntax status, and actionable maintainability signals without retaining or forwarding the code.

- Endpoint: `POST https://apiacre.com/v1/developer/code-metrics`
- Exact price: `$0.025 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.code-metrics
- Browser checkout: https://apiacre.com/try/developer.code-metrics
- Tags: developer, research, code, metrics, complexity, maintainability, static-analysis, python, ast

#### Request example

```json
{
  "code": "def greet(name):\n    return f'Hello {name}'",
  "language": "python"
}
```

#### Input schema

```json
{
  "properties": {
    "code": {
      "maxLength": 2000000,
      "title": "Code",
      "type": "string"
    },
    "language": {
      "default": "text",
      "maxLength": 40,
      "title": "Language",
      "type": "string"
    }
  },
  "required": [
    "code"
  ],
  "title": "CodeMetricsInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "analysis": {
      "limitations": [
        "AST complexity is a static heuristic, not a runtime or control-flow proof.",
        "Comment counts include comment-only lines, not inline comments or block-comment spans."
      ],
      "method": "Python AST with deterministic lexical metrics",
      "version": "apiacre-code-metrics/3"
    },
    "averageLineLength": 21.0,
    "blankLineDensity": 0.0,
    "branchPoints": 0,
    "classes": 0,
    "commentDensity": 0.0,
    "complexityPerFunction": 1.0,
    "estimatedCyclomaticComplexity": 1,
    "functionMetrics": [
      {
        "branchPoints": 0,
        "endLine": 2,
        "estimatedCyclomaticComplexity": 1,
        "kind": "function",
        "line": 1,
        "lines": 2,
        "name": "greet",
        "parameters": 1
      }
    ],
    "functions": 1,
    "functionsTruncated": false,
    "language": "python",
    "lines": {
      "blank": 0,
      "code": 2,
      "comments": 0,
      "total": 2
    },
    "longLineCount": 0,
    "maintainabilitySignal": 95,
    "maximumFunctionComplexity": 1,
    "maximumLineLength": 26,
    "reviewSignals": [],
    "source": {
      "characters": 43,
      "sha256": "d588756864c1c6b9016a1829ea9283915950ef23e5b1c04018413ed71456a34e",
      "utf8Bytes": 43
    },
    "syntax": {
      "engine": "python-ast",
      "error": null,
      "valid": true
    },
    "workMarkerCount": 0
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "after": "$request.code",
          "before": "$baselineSourceCode",
          "filename": "$filename",
          "language": "$request.language"
        },
        "method": "POST",
        "path": "/v1/developer/code-change-review",
        "price": "$0.05",
        "reason": "Compare the measured source with a caller-supplied baseline and surface syntax, complexity, function, and maintainability regressions.",
        "service": "developer.code-change-review",
        "title": "Code change review",
        "use_output": "Inspect result.data.reviewDecision, findings, and functionChanges before approving the change."
      },
      {
        "authorization_required": true,
        "input_template": {
          "content": "$json([$result.data])",
          "format": "json"
        },
        "method": "POST",
        "path": "/v1/data/schema",
        "price": "$0.025",
        "reason": "Create a reusable validation contract for code-quality metric snapshots.",
        "service": "data.schema",
        "title": "Schema inference",
        "use_output": "Use result.data.schema to validate future metric snapshots."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.code-metrics",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Code metrics result",
      "properties": {
        "analysis": {
          "type": "object"
        },
        "averageLineLength": {
          "type": "number"
        },
        "blankLineDensity": {
          "type": "number"
        },
        "branchPoints": {
          "type": "integer"
        },
        "classes": {
          "type": "integer"
        },
        "commentDensity": {
          "type": "number"
        },
        "complexityPerFunction": {
          "type": "number"
        },
        "estimatedCyclomaticComplexity": {
          "type": "integer"
        },
        "functionMetrics": {
          "items": {},
          "type": "array"
        },
        "functions": {
          "type": "integer"
        },
        "functionsTruncated": {
          "type": "boolean"
        },
        "language": {
          "type": [
            "string",
            "null"
          ]
        },
        "lines": {
          "type": "object"
        },
        "longLineCount": {
          "type": "integer"
        },
        "maintainabilitySignal": {
          "type": "integer"
        },
        "maximumFunctionComplexity": {
          "type": "integer"
        },
        "maximumLineLength": {
          "type": "integer"
        },
        "reviewSignals": {
          "items": {},
          "type": "array"
        },
        "source": {
          "type": "object"
        },
        "syntax": {
          "type": "object"
        },
        "workMarkerCount": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.code-metrics",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Code change review (`developer.code-change-review`)

Compare caller-supplied before and after source snapshots without execution or network access, returning source fingerprints, syntax regressions, structural deltas, function-level changes, and bounded review findings.

- Endpoint: `POST https://apiacre.com/v1/developer/code-change-review`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.code-change-review
- Browser checkout: https://apiacre.com/try/developer.code-change-review
- Tags: developer, research, code-review, static-analysis, python

#### Request example

```json
{
  "after": "def invoice_total(items, discount=0):\n    subtotal = sum(item[\"price\"] for item in items)\n    if discount:\n        subtotal *= 1 - discount\n    return subtotal  # TODO: validate discount bounds\n",
  "before": "def invoice_total(items):\n    return sum(item[\"price\"] for item in items)\n",
  "filename": "billing.py",
  "language": "python"
}
```

#### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "after": {
      "maxLength": 1000000,
      "title": "After",
      "type": "string"
    },
    "before": {
      "maxLength": 1000000,
      "title": "Before",
      "type": "string"
    },
    "filename": {
      "anyOf": [
        {
          "maxLength": 260,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Filename"
    },
    "language": {
      "default": "python",
      "maxLength": 40,
      "title": "Language",
      "type": "string"
    }
  },
  "required": [
    "before",
    "after"
  ],
  "title": "CodeChangeReviewInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "after": {
      "branchPoints": 2,
      "classes": 0,
      "estimatedCyclomaticComplexity": 3,
      "functions": 1,
      "lines": {
        "blank": 0,
        "code": 5,
        "comments": 0,
        "total": 5
      },
      "maintainabilitySignal": 87,
      "maximumFunctionComplexity": 3,
      "source": {
        "characters": 194,
        "sha256": "f37990278fe5bda7fdae643ec96f54997271ed3992cefdd5f407736c2e843d00",
        "utf8Bytes": 194
      },
      "syntax": {
        "engine": "python-ast",
        "error": null,
        "valid": true
      }
    },
    "analysis": {
      "limitations": [
        "Static heuristics do not prove runtime behavior, correctness, test coverage, or production safety.",
        "Function-level deltas are complete only when both Python snapshots parse and neither function list is truncated.",
        "Renamed functions appear as one removal and one addition."
      ],
      "method": "two deterministic code-metrics snapshots plus Python function-level deltas",
      "version": "apiacre-code-change-review/1"
    },
    "attentionLevel": "medium",
    "attentionScore": 2,
    "before": {
      "branchPoints": 1,
      "classes": 0,
      "estimatedCyclomaticComplexity": 2,
      "functions": 1,
      "lines": {
        "blank": 0,
        "code": 2,
        "comments": 0,
        "total": 2
      },
      "maintainabilitySignal": 94,
      "maximumFunctionComplexity": 2,
      "source": {
        "characters": 74,
        "sha256": "69316f24997a9cbf73019f697f3f2373e39da67d1835885998775037c600a624",
        "utf8Bytes": 74
      },
      "syntax": {
        "engine": "python-ast",
        "error": null,
        "valid": true
      }
    },
    "changed": true,
    "execution": {
      "codeExecuted": false,
      "networkAccessed": false
    },
    "filename": "billing.py",
    "findings": [
      {
        "evidence": {
          "added": 1
        },
        "id": "new-work-markers",
        "message": "The change adds TODO, FIXME, HACK, or XXX markers.",
        "severity": "low"
      }
    ],
    "functionChanges": {
      "added": [],
      "addedCount": 0,
      "changed": [
        {
          "complexityAfter": 3,
          "complexityBefore": 2,
          "complexityDelta": 1,
          "lineDelta": 3,
          "linesAfter": 5,
          "linesBefore": 2,
          "name": "invoice_total",
          "parameterDelta": 1,
          "parametersAfter": 2,
          "parametersBefore": 1,
          "sourceChanged": true,
          "sourceSha256After": "f37990278fe5bda7fdae643ec96f54997271ed3992cefdd5f407736c2e843d00",
          "sourceSha256Before": "69316f24997a9cbf73019f697f3f2373e39da67d1835885998775037c600a624"
        }
      ],
      "changedCount": 1,
      "removed": [],
      "removedCount": 0,
      "truncated": false
    },
    "language": "python",
    "reviewDecision": "review",
    "summary": {
      "branchPointDelta": 1,
      "classDelta": 0,
      "codeLineDelta": 3,
      "complexityDelta": 1,
      "functionDelta": 0,
      "lineDelta": 3,
      "longLineDelta": 0,
      "maintainabilityDelta": -7,
      "maximumFunctionComplexityDelta": 1,
      "workMarkerDelta": 1
    }
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.code-change-review",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured Code change review result",
      "properties": {
        "after": {
          "additionalProperties": false,
          "properties": {
            "branchPoints": {
              "minimum": 0,
              "type": "integer"
            },
            "classes": {
              "minimum": 0,
              "type": "integer"
            },
            "estimatedCyclomaticComplexity": {
              "minimum": 1,
              "type": "integer"
            },
            "functions": {
              "minimum": 0,
              "type": "integer"
            },
            "lines": {
              "additionalProperties": false,
              "properties": {
                "blank": {
                  "minimum": 0,
                  "type": "integer"
                },
                "code": {
                  "minimum": 0,
                  "type": "integer"
                },
                "comments": {
                  "minimum": 0,
                  "type": "integer"
                },
                "total": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "total",
                "code",
                "comments",
                "blank"
              ],
              "type": "object"
            },
            "maintainabilitySignal": {
              "maximum": 100,
              "minimum": 0,
              "type": "integer"
            },
            "maximumFunctionComplexity": {
              "minimum": 1,
              "type": "integer"
            },
            "source": {
              "additionalProperties": false,
              "properties": {
                "characters": {
                  "maximum": 1000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "sha256": {
                  "pattern": "^[0-9a-f]{64}$",
                  "type": "string"
                },
                "utf8Bytes": {
                  "maximum": 2000000,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "sha256",
                "characters",
                "utf8Bytes"
              ],
              "type": "object"
            },
            "syntax": {
              "additionalProperties": false,
              "properties": {
                "engine": {
                  "enum": [
                    "python-ast",
                    "lexical-heuristics"
                  ],
                  "type": "string"
                },
                "error": {
                  "anyOf": [
                    {
                      "type": "null"
                    },
                    {
                      "additionalProperties": false,
                      "properties": {
                        "line": {
                          "minimum": 1,
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "message": {
                          "maxLength": 200,
                          "type": "string"
                        },
                        "offset": {
                          "minimum": 0,
                          "type": [
                            "integer",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "line",
                        "offset",
                        "message"
                      ],
                      "type": "object"
                    }
                  ]
                },
                "valid": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                }
              },
              "required": [
                "engine",
                "valid",
                "error"
              ],
              "type": "object"
            }
          },
          "required": [
            "source",
            "lines",
            "functions",
            "classes",
            "branchPoints",
            "estimatedCyclomaticComplexity",
            "maximumFunctionComplexity",
            "maintainabilitySignal",
            "syntax"
          ],
          "type": "object"
        },
        "analysis": {
          "additionalProperties": false,
          "properties": {
            "limitations": {
              "items": {
                "type": "string"
              },
              "maxItems": 3,
              "minItems": 3,
              "type": "array"
            },
            "method": {
              "const": "two deterministic code-metrics snapshots plus Python function-level deltas",
              "type": "string"
            },
            "version": {
              "const": "apiacre-code-change-review/1",
              "type": "string"
            }
          },
          "required": [
            "version",
            "method",
            "limitations"
          ],
          "type": "object"
        },
        "attentionLevel": {
          "enum": [
            "clear",
            "medium",
            "high"
          ],
          "type": "string"
        },
        "attentionScore": {
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "before": {
          "additionalProperties": false,
          "properties": {
            "branchPoints": {
              "minimum": 0,
              "type": "integer"
            },
            "classes": {
              "minimum": 0,
              "type": "integer"
            },
            "estimatedCyclomaticComplexity": {
              "minimum": 1,
              "type": "integer"
            },
            "functions": {
              "minimum": 0,
              "type": "integer"
            },
            "lines": {
              "additionalProperties": false,
              "properties": {
                "blank": {
                  "minimum": 0,
                  "type": "integer"
                },
                "code": {
                  "minimum": 0,
                  "type": "integer"
                },
                "comments": {
                  "minimum": 0,
                  "type": "integer"
                },
                "total": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "total",
                "code",
                "comments",
                "blank"
              ],
              "type": "object"
            },
            "maintainabilitySignal": {
              "maximum": 100,
              "minimum": 0,
              "type": "integer"
            },
            "maximumFunctionComplexity": {
              "minimum": 1,
              "type": "integer"
            },
            "source": {
              "additionalProperties": false,
              "properties": {
                "characters": {
                  "maximum": 1000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "sha256": {
                  "pattern": "^[0-9a-f]{64}$",
                  "type": "string"
                },
                "utf8Bytes": {
                  "maximum": 2000000,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "sha256",
                "characters",
                "utf8Bytes"
              ],
              "type": "object"
            },
            "syntax": {
              "additionalProperties": false,
              "properties": {
                "engine": {
                  "enum": [
                    "python-ast",
                    "lexical-heuristics"
                  ],
                  "type": "string"
                },
                "error": {
                  "anyOf": [
                    {
                      "type": "null"
                    },
                    {
                      "additionalProperties": false,
                      "properties": {
                        "line": {
                          "minimum": 1,
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "message": {
                          "maxLength": 200,
                          "type": "string"
                        },
                        "offset": {
                          "minimum": 0,
                          "type": [
                            "integer",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "line",
                        "offset",
                        "message"
                      ],
                      "type": "object"
                    }
                  ]
                },
                "valid": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                }
              },
              "required": [
                "engine",
                "valid",
                "error"
              ],
              "type": "object"
            }
          },
          "required": [
            "source",
            "lines",
            "functions",
            "classes",
            "branchPoints",
            "estimatedCyclomaticComplexity",
            "maximumFunctionComplexity",
            "maintainabilitySignal",
            "syntax"
          ],
          "type": "object"
        },
        "changed": {
          "type": "boolean"
        },
        "execution": {
          "additionalProperties": false,
          "properties": {
            "codeExecuted": {
              "const": false,
              "type": "boolean"
            },
            "networkAccessed": {
              "const": false,
              "type": "boolean"
            }
          },
          "required": [
            "codeExecuted",
            "networkAccessed"
          ],
          "type": "object"
        },
        "filename": {
          "maxLength": 260,
          "type": [
            "string",
            "null"
          ]
        },
        "findings": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "evidence": {
                "type": "object"
              },
              "id": {
                "enum": [
                  "syntax-regression",
                  "invalid-after-snapshot",
                  "complexity-growth",
                  "function-complexity-growth",
                  "maintainability-drop",
                  "new-work-markers",
                  "new-long-lines"
                ],
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "severity": {
                "enum": [
                  "low",
                  "medium",
                  "high"
                ],
                "type": "string"
              }
            },
            "required": [
              "id",
              "severity",
              "message",
              "evidence"
            ],
            "type": "object"
          },
          "maxItems": 7,
          "type": "array"
        },
        "functionChanges": {
          "additionalProperties": false,
          "properties": {
            "added": {
              "items": {
                "minLength": 1,
                "type": "string"
              },
              "maxItems": 200,
              "type": "array"
            },
            "addedCount": {
              "minimum": 0,
              "type": "integer"
            },
            "changed": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "complexityAfter": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "complexityBefore": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "complexityDelta": {
                    "type": "integer"
                  },
                  "lineDelta": {
                    "type": "integer"
                  },
                  "linesAfter": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "linesBefore": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "name": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "parameterDelta": {
                    "type": "integer"
                  },
                  "parametersAfter": {
                    "minimum": 0,
                    "type": "integer"
                  },
                  "parametersBefore": {
                    "minimum": 0,
                    "type": "integer"
                  },
                  "sourceChanged": {
                    "type": "boolean"
                  },
                  "sourceSha256After": {
                    "pattern": "^[0-9a-f]{64}$",
                    "type": "string"
                  },
                  "sourceSha256Before": {
                    "pattern": "^[0-9a-f]{64}$",
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "sourceChanged",
                  "sourceSha256Before",
                  "sourceSha256After",
                  "complexityBefore",
                  "complexityAfter",
                  "complexityDelta",
                  "linesBefore",
                  "linesAfter",
                  "lineDelta",
                  "parametersBefore",
                  "parametersAfter",
                  "parameterDelta"
                ],
                "type": "object"
              },
              "maxItems": 200,
              "type": "array"
            },
            "changedCount": {
              "minimum": 0,
              "type": "integer"
            },
            "removed": {
              "items": {
                "minLength": 1,
                "type": "string"
              },
              "maxItems": 200,
              "type": "array"
            },
            "removedCount": {
              "minimum": 0,
              "type": "integer"
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "addedCount",
            "removedCount",
            "changedCount",
            "added",
            "removed",
            "changed",
            "truncated"
          ],
          "type": "object"
        },
        "language": {
          "maxLength": 40,
          "minLength": 1,
          "type": "string"
        },
        "reviewDecision": {
          "enum": [
            "clear",
            "review",
            "high-attention"
          ],
          "type": "string"
        },
        "summary": {
          "additionalProperties": false,
          "properties": {
            "branchPointDelta": {
              "type": "integer"
            },
            "classDelta": {
              "type": "integer"
            },
            "codeLineDelta": {
              "type": "integer"
            },
            "complexityDelta": {
              "type": "integer"
            },
            "functionDelta": {
              "type": "integer"
            },
            "lineDelta": {
              "type": "integer"
            },
            "longLineDelta": {
              "type": "integer"
            },
            "maintainabilityDelta": {
              "type": "integer"
            },
            "maximumFunctionComplexityDelta": {
              "type": "integer"
            },
            "workMarkerDelta": {
              "type": "integer"
            }
          },
          "required": [
            "lineDelta",
            "codeLineDelta",
            "functionDelta",
            "classDelta",
            "branchPointDelta",
            "complexityDelta",
            "maximumFunctionComplexityDelta",
            "maintainabilityDelta",
            "longLineDelta",
            "workMarkerDelta"
          ],
          "type": "object"
        }
      },
      "required": [
        "changed",
        "filename",
        "language",
        "before",
        "after",
        "summary",
        "functionChanges",
        "reviewDecision",
        "attentionScore",
        "attentionLevel",
        "findings",
        "execution",
        "analysis"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.code-change-review",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### SQL change review (`developer.sql-change-review`)

Statically parse caller-supplied SQL without a database connection or execution, inventory statements and tables, and flag destructive DDL, unfiltered writes, and migration atomicity concerns.

- Endpoint: `POST https://apiacre.com/v1/developer/sql-change-review`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.sql-change-review
- Browser checkout: https://apiacre.com/try/developer.sql-change-review
- Tags: developer, research, sql, database, migration, query, static-analysis, change-review

#### Request example

```json
{
  "dialect": "postgres",
  "sql": "CREATE INDEX idx_accounts_status ON accounts (status);"
}
```

#### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "dialect": {
      "default": "postgres",
      "enum": [
        "postgres",
        "mysql",
        "sqlite",
        "tsql",
        "bigquery",
        "snowflake",
        "duckdb",
        "spark",
        "oracle",
        "redshift"
      ],
      "title": "Dialect",
      "type": "string"
    },
    "sql": {
      "maxLength": 65536,
      "minLength": 1,
      "title": "Sql",
      "type": "string"
    }
  },
  "required": [
    "sql"
  ],
  "title": "SqlChangeReviewInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "attentionLevel": "clear",
    "attentionScore": 0,
    "dialect": "postgres",
    "documentSha256": "3e31b98c852573137d17dcb062b2a1571d63052f71abeeb8b62296f3d1066af4",
    "execution": {
      "databaseConnected": false,
      "sqlExecuted": false
    },
    "findings": [],
    "limitations": [
      "Static syntax review only; database schema, permissions, triggers, data volume, query plans, and runtime behavior are not inspected.",
      "A low attention score does not prove a change is correct or safe to deploy."
    ],
    "parser": {
      "license": "MIT",
      "name": "SQLGlot",
      "version": "30.16.0"
    },
    "reviewDecision": "clear",
    "statementCount": 1,
    "statements": [
      {
        "category": "schema-change",
        "hasLimit": false,
        "hasWhere": false,
        "index": 1,
        "normalizedPreview": "CREATE INDEX idx_accounts_status ON accounts(status)",
        "operation": "CREATE",
        "parameterCount": 0,
        "readOnly": false,
        "referencedTables": [
          "accounts"
        ],
        "sourceTables": [],
        "statementSha256": "532fa1e226f9b47b8a611b319ac0ec776fd283523d5162d4b039e57726d5588a",
        "targetObjects": [
          "accounts"
        ]
      }
    ],
    "summary": {
      "dataChangeStatements": 0,
      "destructiveChanges": 0,
      "otherStatements": 0,
      "readStatements": 0,
      "referencedTables": [
        "accounts"
      ],
      "schemaChangeStatements": 1,
      "targetObjects": [
        "accounts"
      ],
      "transactionStatements": 0,
      "unfilteredDataChanges": 0
    },
    "valid": true
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.sql-change-review",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured SQL change review result",
      "properties": {
        "attentionLevel": {
          "type": "string"
        },
        "attentionScore": {
          "type": "integer"
        },
        "dialect": {
          "type": "string"
        },
        "documentSha256": {
          "type": "string"
        },
        "execution": {
          "type": "object"
        },
        "findings": {
          "items": {},
          "type": "array"
        },
        "limitations": {
          "items": {},
          "type": "array"
        },
        "parser": {
          "type": "object"
        },
        "reviewDecision": {
          "type": "string"
        },
        "statementCount": {
          "type": "integer"
        },
        "statements": {
          "items": {},
          "type": "array"
        },
        "summary": {
          "type": "object"
        },
        "valid": {
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.sql-change-review",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Structured diff (`developer.structured-diff`)

Compare JSON or YAML deterministically and return source hashes plus machine-readable additions, removals, and replacements by path with explicit truncation evidence.

- Endpoint: `POST https://apiacre.com/v1/developer/structured-diff`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.structured-diff
- Browser checkout: https://apiacre.com/try/developer.structured-diff
- Tags: developer, research, json, yaml, diff, compare, config, change-review

#### Request example

```json
{
  "after": "{\"status\":\"approved\",\"features\":{\"export\":true}}",
  "before": "{\"status\":\"draft\",\"features\":{\"export\":false}}",
  "format": "json"
}
```

#### Input schema

```json
{
  "properties": {
    "after": {
      "maxLength": 1000000,
      "title": "After",
      "type": "string"
    },
    "before": {
      "maxLength": 1000000,
      "title": "Before",
      "type": "string"
    },
    "format": {
      "default": "json",
      "enum": [
        "json",
        "yaml"
      ],
      "title": "Format",
      "type": "string"
    }
  },
  "required": [
    "before",
    "after"
  ],
  "title": "StructuredDiffInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "afterSha256": "1491b575597fbdbb636572aa4cf9ac93e424273a4aa920242398844866dd2a0f",
    "beforeSha256": "242eb38c815b9bab51819f9aa7ebd832666455dbfce03671aae54cc93abafcdb",
    "changeCount": 2,
    "changed": true,
    "changes": [
      {
        "after": true,
        "before": false,
        "op": "replace",
        "path": "$.features.export"
      },
      {
        "after": "approved",
        "before": "draft",
        "op": "replace",
        "path": "$.status"
      }
    ],
    "changesReturned": 2,
    "changesTruncated": false,
    "format": "json"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.structured-diff",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Structured diff result",
      "properties": {
        "afterSha256": {
          "type": "string"
        },
        "beforeSha256": {
          "type": "string"
        },
        "changeCount": {
          "type": "integer"
        },
        "changed": {
          "type": "boolean"
        },
        "changes": {
          "description": "Deterministically ordered structural changes; inspect changesTruncated before treating the list as complete.",
          "items": {
            "properties": {
              "after": {},
              "before": {},
              "op": {
                "enum": [
                  "add",
                  "remove",
                  "replace"
                ],
                "type": "string"
              },
              "path": {
                "pattern": "^\\$",
                "type": "string"
              }
            },
            "required": [
              "op",
              "path"
            ],
            "type": "object"
          },
          "maxItems": 5000,
          "type": "array"
        },
        "changesReturned": {
          "type": "integer"
        },
        "changesTruncated": {
          "type": "boolean"
        },
        "format": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.structured-diff",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Feed normalization (`research.feed-normalize`)

Fetch and normalize public RSS or Atom feeds into stable structured JSON entries for agents and research workflows.

- Endpoint: `POST https://apiacre.com/v1/research/feed-normalize`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.feed-normalize
- Browser checkout: https://apiacre.com/try/research.feed-normalize
- Tags: developer, research, rss, atom, feed, news

#### Request example

```json
{
  "url": "https://hnrss.org/frontpage"
}
```

#### Input schema

```json
{
  "properties": {
    "limit": {
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "url": {
      "format": "uri",
      "maxLength": 2083,
      "minLength": 1,
      "title": "Url",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "FeedInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "entries": [
      {
        "id": "https://example.com/posts/engineering-launch",
        "published": "Tue, 11 Aug 2026 04:00:00 +0000",
        "publishedAt": "2026-08-11T04:00:00+00:00",
        "summary": "A bounded example entry normalized from a public RSS item.",
        "title": "Example engineering launch",
        "url": "https://example.com/posts/engineering-launch"
      },
      {
        "id": "https://example.com/posts/api-update",
        "published": "Tue, 11 Aug 2026 03:00:00 +0000",
        "publishedAt": "2026-08-11T03:00:00+00:00",
        "summary": "A second demonstration item with the same stable output fields.",
        "title": "Example API update",
        "url": "https://example.com/posts/api-update"
      }
    ],
    "entryCount": 2,
    "title": "Hacker News: Front Page",
    "url": "https://hnrss.org/frontpage"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.feed-normalize",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Feed normalization result",
      "properties": {
        "entries": {
          "items": {},
          "type": "array"
        },
        "entryCount": {
          "type": "integer"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.feed-normalize",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Multi-feed news aggregation (`research.news-aggregate`)

Merge two to eight public RSS or Atom feeds into a filtered, deduplicated, time-ordered news stream with bounded partial-failure reporting.

- Endpoint: `POST https://apiacre.com/v1/research/news-aggregate`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.news-aggregate
- Browser checkout: https://apiacre.com/try/research.news-aggregate
- Tags: developer, research, rss, atom, news, aggregation, deduplication, monitoring

#### Request example

```json
{
  "deduplicate_by": "url_or_title",
  "feeds": [
    "https://hnrss.org/frontpage",
    "https://www.nasa.gov/feed/"
  ],
  "keywords": [],
  "limit": 25,
  "per_feed_limit": 20
}
```

#### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "deduplicate_by": {
      "default": "url_or_title",
      "enum": [
        "url",
        "title",
        "url_or_title"
      ],
      "title": "Deduplicate By",
      "type": "string"
    },
    "feeds": {
      "items": {
        "format": "uri",
        "maxLength": 2083,
        "minLength": 1,
        "type": "string"
      },
      "maxItems": 8,
      "minItems": 2,
      "title": "Feeds",
      "type": "array"
    },
    "keywords": {
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "title": "Keywords",
      "type": "array"
    },
    "limit": {
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "per_feed_limit": {
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "title": "Per Feed Limit",
      "type": "integer"
    },
    "since_hours": {
      "anyOf": [
        {
          "maximum": 720,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Since Hours"
    }
  },
  "required": [
    "feeds"
  ],
  "title": "NewsAggregateInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "duplicatesRemoved": 1,
    "entries": [
      {
        "id": "https://www.nasa.gov/example/",
        "published": "Sun, 09 Aug 2026 18:00:00 +0000",
        "publishedAt": "2026-08-09T18:00:00+00:00",
        "sourceTitle": "NASA",
        "sourceUrl": "https://www.nasa.gov/feed/",
        "summary": "A normalized entry merged from one of the requested feeds.",
        "title": "A structured public-news example",
        "url": "https://www.nasa.gov/example/"
      }
    ],
    "entryCount": 25,
    "failedFeedCount": 0,
    "feedCount": 2,
    "feeds": [
      {
        "elapsedMs": 118,
        "entryCount": 20,
        "error": null,
        "httpStatus": 200,
        "requestedUrl": "https://hnrss.org/frontpage",
        "status": "ok",
        "title": "Hacker News: Front Page",
        "url": "https://hnrss.org/frontpage"
      },
      {
        "elapsedMs": 164,
        "entryCount": 20,
        "error": null,
        "httpStatus": 200,
        "requestedUrl": "https://www.nasa.gov/feed/",
        "status": "ok",
        "title": "NASA",
        "url": "https://www.nasa.gov/feed/"
      }
    ],
    "filteredOut": 0,
    "retrievedAt": "2026-08-10T00:00:00+00:00",
    "successfulFeedCount": 2
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "content": "$json($result.data.entries)",
          "format": "json"
        },
        "method": "POST",
        "path": "/v1/data/schema",
        "price": "$0.025",
        "reason": "Infer a reusable validation contract for the normalized news entries.",
        "service": "data.schema",
        "title": "Schema inference",
        "use_output": "Use result.data.schema to validate future aggregation snapshots."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.news-aggregate",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Multi-feed news aggregation result",
      "properties": {
        "duplicatesRemoved": {
          "type": "integer"
        },
        "entries": {
          "items": {},
          "type": "array"
        },
        "entryCount": {
          "type": "integer"
        },
        "failedFeedCount": {
          "type": "integer"
        },
        "feedCount": {
          "type": "integer"
        },
        "feeds": {
          "items": {},
          "type": "array"
        },
        "filteredOut": {
          "type": "integer"
        },
        "retrievedAt": {
          "type": "string"
        },
        "successfulFeedCount": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.news-aggregate",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### OpenAPI pytest generator (`developer.openapi-test-generate`)

Generate deterministic, syntax-validated pytest and requests smoke tests from a caller-supplied OpenAPI 3 document, with mutating operations disabled by default.

- Endpoint: `POST https://apiacre.com/v1/developer/openapi-test-generate`
- Exact price: `$0.1 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/developer.openapi-test-generate
- Browser checkout: https://apiacre.com/try/developer.openapi-test-generate
- Tags: developer, openapi, pytest, testing, code-generation, api, requests, smoke-tests

#### Request example

```json
{
  "document": "{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Widget API\",\"version\":\"1\"},\"servers\":[{\"url\":\"https://api.example.com\"}],\"paths\":{\"/health\":{\"get\":{\"operationId\":\"getHealth\",\"responses\":{\"200\":{\"description\":\"Healthy\"}}}},\"/widgets\":{\"post\":{\"operationId\":\"createWidget\",\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"required\":[\"name\"],\"properties\":{\"name\":{\"type\":\"string\",\"example\":\"Acre\"}}}}}},\"responses\":{\"201\":{\"description\":\"Created\"}}}}}}",
  "format": "json",
  "include_optional": false,
  "max_operations": 25,
  "timeout_seconds": 20
}
```

#### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "api_key_env": {
      "default": "API_KEY",
      "maxLength": 64,
      "minLength": 2,
      "title": "Api Key Env",
      "type": "string"
    },
    "base_url": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Base Url"
    },
    "bearer_token_env": {
      "default": "API_BEARER_TOKEN",
      "maxLength": 64,
      "minLength": 2,
      "title": "Bearer Token Env",
      "type": "string"
    },
    "document": {
      "maxLength": 524288,
      "minLength": 1,
      "title": "Document",
      "type": "string"
    },
    "format": {
      "default": "yaml",
      "enum": [
        "json",
        "yaml"
      ],
      "title": "Format",
      "type": "string"
    },
    "include_optional": {
      "default": false,
      "title": "Include Optional",
      "type": "boolean"
    },
    "max_operations": {
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "title": "Max Operations",
      "type": "integer"
    },
    "timeout_seconds": {
      "default": 20,
      "maximum": 120,
      "minimum": 1,
      "title": "Timeout Seconds",
      "type": "integer"
    }
  },
  "required": [
    "document"
  ],
  "title": "OpenApiTestGenerateInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "apiTitle": "Widget API",
    "baseUrlDefault": "https://api.example.com",
    "documentSha256": "2f27879b24323466c5dbca7df9bf137561b826bd43c318b8642b92f04b17930d",
    "environment": {
      "allowMutatingTests": "API_ALLOW_MUTATING_TESTS",
      "apiKey": "API_KEY",
      "baseUrl": "API_BASE_URL",
      "bearerToken": "API_BEARER_TOKEN"
    },
    "execution": {
      "generatedTestsExecuted": false,
      "networkRequestsMade": false,
      "sourceSyntaxValidated": true
    },
    "generatedTestCount": 2,
    "guardedMutationCount": 1,
    "openapiVersion": "3.1.0",
    "operationCount": 2,
    "operations": [
      {
        "documentedResponses": [
          "200"
        ],
        "method": "GET",
        "mutatingGuard": false,
        "operationId": "getHealth",
        "path": "/health",
        "testName": "test_gethealth"
      },
      {
        "documentedResponses": [
          "201"
        ],
        "method": "POST",
        "mutatingGuard": true,
        "operationId": "createWidget",
        "path": "/widgets",
        "testName": "test_createwidget"
      }
    ],
    "requirements": [
      "pytest>=8",
      "requests>=2.31"
    ],
    "source": "\"\"\"Generated API smoke tests. Review targets and payloads before running.\"\"\"\n\nimport os\n\nimport pytest\nimport requests\n\nDEFAULT_BASE_URL = 'https://api.example.com'\nBASE_URL = os.environ.get(\"API_BASE_URL\", DEFAULT_BASE_URL).rstrip(\"/\")\nTIMEOUT_SECONDS = 20\n\n\ndef _require_base_url():\n    if not BASE_URL:\n        pytest.skip(\"Set API_BASE_URL to the API origin\")\n    return BASE_URL\n\n\ndef _headers(extra=None):\n    headers = dict(extra or {})\n    if token := os.environ.get('API_BEARER_TOKEN'):\n        headers[\"Authorization\"] = f\"Bearer {token}\"\n    if api_key := os.environ.get('API_KEY'):\n        headers[\"X-API-Key\"] = api_key\n    return headers\n\n\ndef test_gethealth():\n    base_url = _require_base_url()\n    response = requests.request('GET', base_url + '/health', headers=_headers({}), timeout=TIMEOUT_SECONDS)\n    assert response.status_code in [200]\n\n@pytest.mark.skipif(\n    os.environ.get(\"API_ALLOW_MUTATING_TESTS\") != \"1\",\n    reason=\"POST test disabled; set API_ALLOW_MUTATING_TESTS=1\",\n)\ndef test_createwidget():\n    base_url = _require_base_url()\n    response = requests.request('POST', base_url + '/widgets', headers=_headers({}), json={'name': 'Acre'}, timeout=TIMEOUT_SECONDS)\n    assert response.status_code in [201]\n",
    "sourceFileName": "test_openapi_generated.py",
    "sourceSha256": "44d05573bd64ef63deb934c9bef7b1ed6c618e4093c9cc7eee8e3a55b12b0f26",
    "truncated": false,
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "developer.openapi-test-generate",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured OpenAPI pytest generator result",
      "properties": {
        "apiTitle": {
          "type": "string"
        },
        "baseUrlDefault": {
          "type": "string"
        },
        "documentSha256": {
          "type": "string"
        },
        "environment": {
          "type": "object"
        },
        "execution": {
          "type": "object"
        },
        "generatedTestCount": {
          "type": "integer"
        },
        "guardedMutationCount": {
          "type": "integer"
        },
        "openapiVersion": {
          "type": "string"
        },
        "operationCount": {
          "type": "integer"
        },
        "operations": {
          "items": {},
          "type": "array"
        },
        "requirements": {
          "items": {},
          "type": "array"
        },
        "source": {
          "type": "string"
        },
        "sourceFileName": {
          "type": "string"
        },
        "sourceSha256": {
          "type": "string"
        },
        "truncated": {
          "type": "boolean"
        },
        "warnings": {
          "items": {},
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "developer.openapi-test-generate",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### U.S. federal contract search (`research.us-contract-search`)

Search public USAspending prime federal procurement awards by recipient organization name, UEI, or legacy DUNS, returning bounded contract values, agencies, performance dates, descriptions, official award links, and explicit interpretation limits.

- Endpoint: `POST https://apiacre.com/v1/research/us-contract-search`
- Exact price: `$0.02 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.us-contract-search
- Browser checkout: https://apiacre.com/try/research.us-contract-search
- Tags: research, government, usa-spending, federal-contracts, procurement, awards, recipient, official-data, government-spending, contract-awards

#### Request example

```json
{
  "end_date": "2026-08-13",
  "max_results": 5,
  "minimum_award_amount": 1000000,
  "recipient_query": "Palantir USG",
  "start_date": "2024-01-01"
}
```

#### Input schema

```json
{
  "properties": {
    "end_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional inclusive award-action upper bound; defaults to today",
      "examples": [
        "2026-08-13"
      ],
      "title": "End Date"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum highest-award-amount prime contracts returned",
      "maximum": 25,
      "minimum": 1,
      "title": "Max Results",
      "type": "integer"
    },
    "maximum_award_amount": {
      "anyOf": [
        {
          "maximum": 1000000000000,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional maximum current aggregate contract-award amount in whole USD",
      "title": "Maximum Award Amount"
    },
    "minimum_award_amount": {
      "anyOf": [
        {
          "maximum": 1000000000000,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional minimum current aggregate contract-award amount in whole USD",
      "examples": [
        1000000
      ],
      "title": "Minimum Award Amount"
    },
    "recipient_query": {
      "description": "Recipient organization name, UEI, or legacy DUNS to search across public USAspending prime-contract records",
      "examples": [
        "Palantir USG"
      ],
      "maxLength": 120,
      "minLength": 2,
      "title": "Recipient Query",
      "type": "string"
    },
    "start_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional inclusive award-action lower bound; defaults to five years before end_date",
      "examples": [
        "2024-01-01"
      ],
      "title": "Start Date"
    }
  },
  "required": [
    "recipient_query"
  ],
  "title": "UsContractSearchInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "awards": [
      {
        "awardAmountUsd": 545578476.94,
        "awardId": "W9128Z26FA001",
        "awardType": "DELIVERY ORDER",
        "awardingAgency": "Department of Defense",
        "awardingSubAgency": "Department of the Army",
        "description": "CDAO MSS TASK ORDER OFF OF CONTRACT W519TC25D0039",
        "endDate": "2029-05-31",
        "fundingAgency": "Department of Defense",
        "fundingSubAgency": "Department of the Army",
        "generatedInternalId": "CONT_AWD_W9128Z26FA001_9700_W519TC25D0039_9700",
        "internalId": 355423040,
        "lastModifiedAtSource": "2026-05-14 13:09:08",
        "officialAwardUrl": "https://www.usaspending.gov/award/CONT_AWD_W9128Z26FA001_9700_W519TC25D0039_9700/",
        "recipientName": "PALANTIR USG INC",
        "recipientUei": "HNN4F9JZWDY8",
        "startDate": "2025-10-15"
      }
    ],
    "awardsReturned": 5,
    "awardsSkipped": 0,
    "disclaimer": "Public federal procurement evidence for research only; verify the official award record before legal, compliance, credit, investment, or contracting decisions.",
    "documentation": "https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/search/spending_by_award.md",
    "hasMore": true,
    "limitations": [
      "Recipient search is fuzzy across names, UEIs, and legacy DUNS values; a result does not prove identity, ownership, affiliation, or current status.",
      "Award Amount is USAspending's current aggregate award value, not necessarily cash paid, current obligations, revenue, profit, or remaining contract value.",
      "Results are prime contracts only, sorted by aggregate award amount, limited to page one and the requested date range, and may be revised or incomplete."
    ],
    "query": {
      "awardScope": "prime contracts",
      "awardTypeCodes": [
        "A",
        "B",
        "C",
        "D"
      ],
      "endDate": "2026-08-13",
      "maxResults": 5,
      "maximumAwardAmountUsd": null,
      "minimumAwardAmountUsd": 1000000,
      "recipientFieldsSearched": [
        "name",
        "UEI",
        "legacy DUNS"
      ],
      "recipientQuery": "Palantir USG",
      "sort": "award amount descending",
      "startDate": "2024-01-01"
    },
    "resultsReceived": 5,
    "retrievedAt": "2026-08-13T07:00:00+00:00",
    "source": "https://api.usaspending.gov/api/v2/search/spending_by_award/",
    "sourceMessages": [
      "USAspending search dates are limited to records from 2007-10-01 onward."
    ]
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "country_code": "US",
          "legal_name": "$result.data.awards[0].recipientName",
          "max_results": 3
        },
        "method": "POST",
        "path": "/v1/research/lei-entity-search",
        "price": "$0.01",
        "reason": "Resolve a selected contract recipient against official GLEIF legal-entity records before combining organization evidence.",
        "service": "research.lei-entity-search",
        "title": "GLEIF legal entity search",
        "use_output": "Run only after selecting the intended award recipient; a name match does not prove that the GLEIF entity and USAspending recipient are the same organization."
      },
      {
        "authorization_required": true,
        "input_template": {
          "legal_name": "$result.data.awards[0].recipientName"
        },
        "method": "POST",
        "path": "/v1/research/organization-evidence",
        "price": "$0.1",
        "reason": "Broaden a selected award recipient into one independently sourced GLEIF, USAspending, SEC filing-activity, and OFAC Entity evidence pack.",
        "service": "research.organization-evidence",
        "title": "Official organization evidence bundle",
        "use_output": "Run only after selecting the intended recipient. Compare each source independently; the bundle explicitly does not establish cross-source identity, linkage, risk, or compliance."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.us-contract-search",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured U.S. federal contract search result",
      "properties": {
        "awards": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "awardAmountUsd": {
                "type": "number"
              },
              "awardId": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "awardType": {
                "maxLength": 160,
                "type": [
                  "string",
                  "null"
                ]
              },
              "awardingAgency": {
                "maxLength": 300,
                "type": [
                  "string",
                  "null"
                ]
              },
              "awardingSubAgency": {
                "maxLength": 300,
                "type": [
                  "string",
                  "null"
                ]
              },
              "description": {
                "maxLength": 5000,
                "type": [
                  "string",
                  "null"
                ]
              },
              "endDate": {
                "format": "date",
                "type": [
                  "string",
                  "null"
                ]
              },
              "fundingAgency": {
                "maxLength": 300,
                "type": [
                  "string",
                  "null"
                ]
              },
              "fundingSubAgency": {
                "maxLength": 300,
                "type": [
                  "string",
                  "null"
                ]
              },
              "generatedInternalId": {
                "maxLength": 500,
                "minLength": 1,
                "type": "string"
              },
              "internalId": {
                "minimum": 1,
                "type": "integer"
              },
              "lastModifiedAtSource": {
                "maxLength": 32,
                "type": [
                  "string",
                  "null"
                ]
              },
              "officialAwardUrl": {
                "format": "uri",
                "pattern": "^https://www\\.usaspending\\.gov/award/",
                "type": "string"
              },
              "recipientName": {
                "maxLength": 500,
                "minLength": 1,
                "type": "string"
              },
              "recipientUei": {
                "pattern": "^[A-Z0-9]{12}$",
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "format": "date",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "internalId",
              "awardId",
              "recipientName",
              "recipientUei",
              "awardAmountUsd",
              "awardType",
              "description",
              "startDate",
              "endDate",
              "lastModifiedAtSource",
              "awardingAgency",
              "awardingSubAgency",
              "fundingAgency",
              "fundingSubAgency",
              "generatedInternalId",
              "officialAwardUrl"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        },
        "awardsReturned": {
          "maximum": 25,
          "minimum": 0,
          "type": "integer"
        },
        "awardsSkipped": {
          "maximum": 25,
          "minimum": 0,
          "type": "integer"
        },
        "disclaimer": {
          "maxLength": 500,
          "type": "string"
        },
        "documentation": {
          "format": "uri",
          "type": "string"
        },
        "hasMore": {
          "type": "boolean"
        },
        "limitations": {
          "items": {
            "maxLength": 500,
            "type": "string"
          },
          "maxItems": 3,
          "minItems": 3,
          "type": "array"
        },
        "query": {
          "additionalProperties": false,
          "properties": {
            "awardScope": {
              "const": "prime contracts",
              "type": "string"
            },
            "awardTypeCodes": {
              "const": [
                "A",
                "B",
                "C",
                "D"
              ],
              "type": "array"
            },
            "endDate": {
              "format": "date",
              "type": "string"
            },
            "maxResults": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer"
            },
            "maximumAwardAmountUsd": {
              "maximum": 1000000000000,
              "minimum": 0,
              "type": [
                "integer",
                "null"
              ]
            },
            "minimumAwardAmountUsd": {
              "maximum": 1000000000000,
              "minimum": 0,
              "type": [
                "integer",
                "null"
              ]
            },
            "recipientFieldsSearched": {
              "const": [
                "name",
                "UEI",
                "legacy DUNS"
              ],
              "type": "array"
            },
            "recipientQuery": {
              "maxLength": 120,
              "minLength": 2,
              "type": "string"
            },
            "sort": {
              "const": "award amount descending",
              "type": "string"
            },
            "startDate": {
              "format": "date",
              "type": "string"
            }
          },
          "required": [
            "recipientQuery",
            "recipientFieldsSearched",
            "startDate",
            "endDate",
            "minimumAwardAmountUsd",
            "maximumAwardAmountUsd",
            "awardTypeCodes",
            "awardScope",
            "sort",
            "maxResults"
          ],
          "type": "object"
        },
        "resultsReceived": {
          "maximum": 25,
          "minimum": 0,
          "type": "integer"
        },
        "retrievedAt": {
          "format": "date-time",
          "type": "string"
        },
        "source": {
          "const": "https://api.usaspending.gov/api/v2/search/spending_by_award/",
          "type": "string"
        },
        "sourceMessages": {
          "items": {
            "maxLength": 1000,
            "type": "string"
          },
          "maxItems": 10,
          "type": "array"
        }
      },
      "required": [
        "query",
        "resultsReceived",
        "awardsReturned",
        "awardsSkipped",
        "hasMore",
        "awards",
        "sourceMessages",
        "source",
        "documentation",
        "retrievedAt",
        "limitations",
        "disclaimer"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.us-contract-search",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Federal Register document search (`research.federal-register-search`)

Search newest U.S. Federal Register document metadata by topic, agency, type, and publication date, returning bounded regulatory notices, rules, proposed rules, presidential documents, and links to FederalRegister.gov and official govinfo.gov PDFs.

- Endpoint: `POST https://apiacre.com/v1/research/federal-register-search`
- Exact price: `$0.02 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.federal-register-search
- Browser checkout: https://apiacre.com/try/research.federal-register-search
- Tags: research, government, regulation, federal-register, rules, notices, policy, official-data, regulatory-intelligence, rulemaking, proposed-rules

#### Request example

```json
{
  "agency_slugs": [
    "commerce-department"
  ],
  "document_types": [
    "NOTICE",
    "PRORULE"
  ],
  "max_results": 10,
  "published_from": "2026-01-01",
  "query": "artificial intelligence"
}
```

#### Input schema

```json
{
  "properties": {
    "agency_slugs": {
      "description": "Optional exact FederalRegister.gov agency slugs, such as commerce-department",
      "examples": [
        [
          "commerce-department"
        ]
      ],
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "title": "Agency Slugs",
      "type": "array"
    },
    "document_types": {
      "description": "Optional document types: RULE, PRORULE, NOTICE, or PRESDOCU",
      "items": {
        "enum": [
          "RULE",
          "PRORULE",
          "NOTICE",
          "PRESDOCU"
        ],
        "type": "string"
      },
      "maxItems": 4,
      "title": "Document Types",
      "type": "array"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum newest-first documents returned",
      "maximum": 25,
      "minimum": 1,
      "title": "Max Results",
      "type": "integer"
    },
    "published_from": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional inclusive publication-date lower bound",
      "examples": [
        "2026-01-01"
      ],
      "title": "Published From"
    },
    "published_to": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional inclusive publication-date upper bound",
      "examples": [
        "2026-12-31"
      ],
      "title": "Published To"
    },
    "query": {
      "anyOf": [
        {
          "maxLength": 200,
          "minLength": 2,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional full-text Federal Register search term",
      "examples": [
        "artificial intelligence"
      ],
      "title": "Query"
    }
  },
  "title": "FederalRegisterSearchInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "description": "Documents matching 'artificial intelligence', published on or after 01/01/2026, from Commerce Department, and of type Notice or Proposed Rule",
    "disclaimer": "Public regulatory-document discovery for research only; verify the linked official edition before legal, compliance, or deadline decisions.",
    "documentation": "https://www.federalregister.gov/developers/documentation/api/v1",
    "documents": [
      {
        "abstract": "NIST seeks stakeholder input on opportunities, challenges, and priorities for modernizing the National Vulnerability Database.",
        "action": "Notice; Request for Information (RFI).",
        "agencies": [
          {
            "name": "National Institute of Standards and Technology",
            "slug": "national-institute-of-standards-and-technology"
          }
        ],
        "citation": "91 FR 52042",
        "dates": "Comments must be received on or before October 13, 2026.",
        "docketIds": [],
        "documentNumber": "2026-16371",
        "executiveOrderNumber": null,
        "htmlUrl": "https://www.federalregister.gov/documents/2026/08/12/2026-16371/request-for-information-rfi-on-modernizing-the-national-vulnerability-database-in-the-age-of",
        "officialPdfUrl": "https://www.govinfo.gov/content/pkg/FR-2026-08-12/pdf/2026-16371.pdf",
        "president": "Donald Trump",
        "publicInspectionPdfUrl": "https://public-inspection.federalregister.gov/2026-16371.pdf",
        "publicationDate": "2026-08-12",
        "regulationIds": [],
        "significant": null,
        "title": "Request for Information (RFI) on Modernizing the National Vulnerability Database in the Age of Artificial Intelligence",
        "topics": [],
        "type": "Notice"
      }
    ],
    "documentsReturned": 1,
    "documentsTruncated": true,
    "limitations": [
      "Results are newest-first and bounded by max_results; totalMatches may exceed the returned documents.",
      "FederalRegister.gov is an unofficial informational display and does not replace the official print or govinfo.gov editions.",
      "Search results, abstracts, dates text, agency metadata, and significance flags may be absent or incomplete."
    ],
    "query": {
      "agencySlugs": [
        "commerce-department"
      ],
      "documentTypes": [
        "NOTICE",
        "PRORULE"
      ],
      "maxResults": 10,
      "order": "newest",
      "publishedFrom": "2026-01-01",
      "publishedTo": null,
      "term": "artificial intelligence"
    },
    "retrievedAt": "2026-08-13T00:00:00Z",
    "source": "https://www.federalregister.gov/api/v1/documents.json",
    "totalMatches": 12
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.federal-register-search",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Federal Register document search result",
      "properties": {
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "disclaimer": {
          "type": "string"
        },
        "documentation": {
          "type": "string"
        },
        "documents": {
          "items": {},
          "type": "array"
        },
        "documentsReturned": {
          "type": "integer"
        },
        "documentsTruncated": {
          "type": "boolean"
        },
        "limitations": {
          "items": {},
          "type": "array"
        },
        "query": {
          "type": "object"
        },
        "retrievedAt": {
          "type": "string"
        },
        "source": {
          "type": "string"
        },
        "totalMatches": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.federal-register-search",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### OFAC entity candidate evidence (`research.ofac-entity-search`)

Compare a business or organization name with separately named Entity records and aliases in the official OFAC SDN and Consolidated Non-SDN files, returning deterministic candidate scores, program tags, source hashes, and freshness evidence without issuing an allow or block verdict.

- Endpoint: `POST https://apiacre.com/v1/research/ofac-entity-search`
- Exact price: `$0.02 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.ofac-entity-search
- Browser checkout: https://apiacre.com/try/research.ofac-entity-search
- Tags: research, ofac, sanctions, entity, business, candidate-search, official-data, due-diligence, evidence

#### Request example

```json
{
  "entity_name": "AEROCARIBBEAN AIRLINES",
  "include_weak_aliases": false,
  "max_results": 5,
  "minimum_score": 85
}
```

#### Input schema

```json
{
  "properties": {
    "entity_name": {
      "description": "Organization or business name to compare with separately named OFAC Entity records",
      "examples": [
        "AEROCARIBBEAN AIRLINES"
      ],
      "maxLength": 200,
      "minLength": 3,
      "title": "Entity Name",
      "type": "string"
    },
    "include_weak_aliases": {
      "default": false,
      "description": "Include aliases that OFAC labels weak and warns may create false positives",
      "title": "Include Weak Aliases",
      "type": "boolean"
    },
    "max_results": {
      "default": 5,
      "description": "Maximum candidate records to return after deterministic ranking",
      "maximum": 10,
      "minimum": 1,
      "title": "Max Results",
      "type": "integer"
    },
    "minimum_score": {
      "default": 85,
      "description": "Minimum API Acre similarity score to return; this is not OFAC's interactive-search score",
      "maximum": 100,
      "minimum": 70,
      "title": "Minimum Score",
      "type": "integer"
    }
  },
  "required": [
    "entity_name"
  ],
  "title": "OfacEntitySearchInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "candidateCount": 1,
    "candidates": [
      {
        "countries": [
          "Cuba"
        ],
        "entityType": "Entity",
        "listKind": "sdn",
        "listLabel": "SDN",
        "match": {
          "aliasQuality": null,
          "matchedField": "primary",
          "matchedName": "AEROCARIBBEAN AIRLINES",
          "method": "exact",
          "score": 100.0,
          "scoreAuthority": "API Acre; not the OFAC Sanctions List Search score"
        },
        "primaryName": "AEROCARIBBEAN AIRLINES",
        "programs": [
          "CUBA"
        ],
        "sourceFileUrl": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/sdn.xml",
        "uid": "36"
      }
    ],
    "candidatesReturned": 1,
    "candidatesTruncated": false,
    "dataset": {
      "cacheMaxAgeSeconds": 3600,
      "files": [
        {
          "entityRecordCount": 9854,
          "filename": "sdn.xml",
          "listKind": "sdn",
          "listLabel": "SDN",
          "publishDate": "2026-08-07",
          "recordCount": 19199,
          "sha256": "ac00228a68345e5c0d7174713cf97e5d5a8efe7cec5c2f540ed87106f49f7474",
          "sourceUrl": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/sdn.xml"
        },
        {
          "entityRecordCount": 363,
          "filename": "consolidated.xml",
          "listKind": "consolidated-non-sdn",
          "listLabel": "Consolidated Non-SDN",
          "publishDate": "2026-07-27",
          "recordCount": 481,
          "sha256": "6c9eb74d6060a8c7075dd48054e087cb83c7ccd935dfd4df6700635e12d7c84f",
          "sourceUrl": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/consolidated.xml"
        }
      ],
      "snapshotFetchedAt": "2026-08-12T02:00:00+00:00"
    },
    "disclaimer": "Evidence aid only. Not legal advice, a compliance certification, or a sole basis for an allow, deny, freeze, or reporting decision.",
    "guidance": {
      "automation": "https://ofac.treasury.gov/faqs/287",
      "fiftyPercentRule": "https://ofac.treasury.gov/faqs/10"
    },
    "limitations": [
      "Results are name-similarity candidates for manual review, not a determination that the queried entity is listed or that a transaction is permitted or prohibited.",
      "This search covers separately named Entity records and their aliases only; it excludes individuals, vessels, aircraft, ownership analysis, geographic restrictions, and entities blocked under OFAC's 50 Percent Rule but not separately listed.",
      "Different OFAC lists and program tags carry different restrictions; inspect the current official record, program, and legal authority before acting.",
      "Name-only screening can produce false positives and false negatives. Weak aliases are excluded by default because OFAC warns they may create many false hits."
    ],
    "query": {
      "entityName": "AEROCARIBBEAN AIRLINES",
      "entityType": "Entity",
      "includeWeakAliases": false,
      "maxResults": 5,
      "minimumScore": 85,
      "normalizedName": "aerocaribbean airlines"
    },
    "retrievedAt": "2026-08-12T02:00:01+00:00",
    "source": "https://ofac.treasury.gov/sanctions-list-service",
    "status": "candidates_found"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "legal_name": "$request.entity_name"
        },
        "method": "POST",
        "path": "/v1/research/organization-evidence",
        "price": "$0.1",
        "reason": "Add independent GLEIF legal-entity, USAspending prime-contract, and SEC filing-activity evidence for the organization name without turning the OFAC candidates into a verdict.",
        "service": "research.organization-evidence",
        "title": "Official organization evidence bundle",
        "use_output": "Use the four source sections as separate evidence. Candidate similarity does not establish identity, sanctions status, cross-source linkage, or compliance clearance."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.ofac-entity-search",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured OFAC entity candidate evidence result",
      "properties": {
        "candidateCount": {
          "minimum": 0,
          "type": "integer"
        },
        "candidates": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "countries": {
                "items": {
                  "maxLength": 120,
                  "type": "string"
                },
                "maxItems": 10,
                "type": "array",
                "uniqueItems": true
              },
              "entityType": {
                "const": "Entity",
                "type": "string"
              },
              "listKind": {
                "enum": [
                  "sdn",
                  "consolidated-non-sdn"
                ],
                "type": "string"
              },
              "listLabel": {
                "enum": [
                  "SDN",
                  "Consolidated Non-SDN"
                ],
                "type": "string"
              },
              "match": {
                "additionalProperties": false,
                "properties": {
                  "aliasQuality": {
                    "enum": [
                      "strong",
                      "weak",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "matchedField": {
                    "enum": [
                      "primary",
                      "alias"
                    ],
                    "type": "string"
                  },
                  "matchedName": {
                    "maxLength": 500,
                    "minLength": 1,
                    "type": "string"
                  },
                  "method": {
                    "enum": [
                      "exact",
                      "deterministic_name_similarity"
                    ],
                    "type": "string"
                  },
                  "score": {
                    "maximum": 100,
                    "minimum": 0,
                    "type": "number"
                  },
                  "scoreAuthority": {
                    "type": "string"
                  }
                },
                "required": [
                  "matchedName",
                  "matchedField",
                  "aliasQuality",
                  "score",
                  "method",
                  "scoreAuthority"
                ],
                "type": "object"
              },
              "primaryName": {
                "maxLength": 500,
                "minLength": 1,
                "type": "string"
              },
              "programs": {
                "items": {
                  "maxLength": 120,
                  "type": "string"
                },
                "maxItems": 100,
                "type": "array",
                "uniqueItems": true
              },
              "sourceFileUrl": {
                "format": "uri",
                "type": "string"
              },
              "uid": {
                "pattern": "^[0-9]+$",
                "type": "string"
              }
            },
            "required": [
              "uid",
              "primaryName",
              "entityType",
              "listKind",
              "listLabel",
              "programs",
              "countries",
              "match",
              "sourceFileUrl"
            ],
            "type": "object"
          },
          "maxItems": 10,
          "type": "array"
        },
        "candidatesReturned": {
          "maximum": 10,
          "minimum": 0,
          "type": "integer"
        },
        "candidatesTruncated": {
          "type": "boolean"
        },
        "dataset": {
          "additionalProperties": false,
          "properties": {
            "cacheMaxAgeSeconds": {
              "const": 3600,
              "type": "integer"
            },
            "files": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "entityRecordCount": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "filename": {
                    "enum": [
                      "sdn.xml",
                      "consolidated.xml"
                    ],
                    "type": "string"
                  },
                  "listKind": {
                    "enum": [
                      "sdn",
                      "consolidated-non-sdn"
                    ],
                    "type": "string"
                  },
                  "listLabel": {
                    "enum": [
                      "SDN",
                      "Consolidated Non-SDN"
                    ],
                    "type": "string"
                  },
                  "publishDate": {
                    "format": "date",
                    "type": "string"
                  },
                  "recordCount": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "sha256": {
                    "pattern": "^[0-9a-f]{64}$",
                    "type": "string"
                  },
                  "sourceUrl": {
                    "format": "uri",
                    "type": "string"
                  }
                },
                "required": [
                  "listKind",
                  "listLabel",
                  "filename",
                  "publishDate",
                  "recordCount",
                  "entityRecordCount",
                  "sha256",
                  "sourceUrl"
                ],
                "type": "object"
              },
              "maxItems": 2,
              "minItems": 2,
              "type": "array"
            },
            "snapshotFetchedAt": {
              "format": "date-time",
              "type": "string"
            }
          },
          "required": [
            "snapshotFetchedAt",
            "cacheMaxAgeSeconds",
            "files"
          ],
          "type": "object"
        },
        "disclaimer": {
          "type": "string"
        },
        "guidance": {
          "additionalProperties": false,
          "properties": {
            "automation": {
              "const": "https://ofac.treasury.gov/faqs/287",
              "type": "string"
            },
            "fiftyPercentRule": {
              "const": "https://ofac.treasury.gov/faqs/10",
              "type": "string"
            }
          },
          "required": [
            "automation",
            "fiftyPercentRule"
          ],
          "type": "object"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "maxItems": 4,
          "minItems": 4,
          "type": "array"
        },
        "query": {
          "additionalProperties": false,
          "properties": {
            "entityName": {
              "maxLength": 200,
              "minLength": 3,
              "type": "string"
            },
            "entityType": {
              "const": "Entity",
              "type": "string"
            },
            "includeWeakAliases": {
              "type": "boolean"
            },
            "maxResults": {
              "maximum": 10,
              "minimum": 1,
              "type": "integer"
            },
            "minimumScore": {
              "maximum": 100,
              "minimum": 70,
              "type": "integer"
            },
            "normalizedName": {
              "maxLength": 200,
              "minLength": 3,
              "type": "string"
            }
          },
          "required": [
            "entityName",
            "normalizedName",
            "entityType",
            "minimumScore",
            "maxResults",
            "includeWeakAliases"
          ],
          "type": "object"
        },
        "retrievedAt": {
          "format": "date-time",
          "type": "string"
        },
        "source": {
          "const": "https://ofac.treasury.gov/sanctions-list-service",
          "type": "string"
        },
        "status": {
          "enum": [
            "candidates_found",
            "no_candidates_above_threshold"
          ],
          "type": "string"
        }
      },
      "required": [
        "status",
        "query",
        "candidateCount",
        "candidatesReturned",
        "candidatesTruncated",
        "candidates",
        "dataset",
        "source",
        "retrievedAt",
        "limitations",
        "guidance",
        "disclaimer"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.ofac-entity-search",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Official organization evidence bundle (`research.organization-evidence`)

Search one organization independently across official GLEIF legal-entity, USAspending prime-contract, SEC filing-activity, and OFAC Entity records, returning bounded evidence and source-specific coverage without asserting identity, linkage, risk, or compliance.

- Endpoint: `POST https://apiacre.com/v1/research/organization-evidence`
- Exact price: `$0.1 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.organization-evidence
- Browser checkout: https://apiacre.com/try/research.organization-evidence
- Tags: research, organization, company, business, company-enrichment, business-intelligence, corporate-intelligence, organization-profile, vendor-screening, supplier-screening, counterparty-research, background-check, due-diligence, gleif, lei, usa-spending, federal-contracts, sec, ofac, official-data, kyb

#### Request example

```json
{
  "country_code": "US",
  "legal_name": "Apple Inc.",
  "sec_identifier": "AAPL"
}
```

#### Input schema

```json
{
  "properties": {
    "country_code": {
      "anyOf": [
        {
          "pattern": "^[A-Za-z]{2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional ISO 3166-1 alpha-2 filter applied only to GLEIF candidates",
      "examples": [
        "US"
      ],
      "title": "Country Code"
    },
    "legal_name": {
      "description": "Organization legal or trading name used independently across official GLEIF, USAspending, SEC, and OFAC organization records",
      "examples": [
        "Palantir Technologies Inc."
      ],
      "maxLength": 200,
      "minLength": 2,
      "title": "Legal Name",
      "type": "string"
    },
    "sec_identifier": {
      "anyOf": [
        {
          "maxLength": 20,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional SEC ticker or CIK; when absent, the exact organization name is resolved against the SEC company directory",
      "examples": [
        "PLTR"
      ],
      "title": "Sec Identifier"
    }
  },
  "required": [
    "legal_name"
  ],
  "title": "OrganizationEvidenceInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "counts": {
      "federalContractAwards": 0,
      "legalEntityCandidates": 1,
      "ofacEntityCandidates": 0,
      "secFilings": 0,
      "secSignals": 0
    },
    "coverage": {
      "availableSectionCount": 4,
      "partial": false,
      "requestedSectionCount": 4,
      "sections": {
        "federalContracts": "available",
        "legalEntity": "available",
        "ofacEntityCandidates": "available",
        "secFilingActivity": "available"
      }
    },
    "crossSourceLinkage": "not_established",
    "disclaimer": "Official public organization evidence for research only; not legal, sanctions, compliance, investment, credit, procurement, accounting, or KYC advice.",
    "federalContracts": {
      "data": {
        "awards": [],
        "awardsReturned": 0,
        "hasMore": false
      },
      "source": "https://api.usaspending.gov/api/v2/search/spending_by_award/",
      "status": "available"
    },
    "legalEntity": {
      "data": {
        "license": {
          "id": "CC0-1.0"
        },
        "matchCount": 1,
        "matches": [
          {
            "entityStatus": "ACTIVE",
            "legalName": "Apple Inc.",
            "lei": "HWUPKR0MPOU8FGXBT394",
            "match": {
              "score": 1.0,
              "type": "exact"
            },
            "source": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394"
          }
        ],
        "status": "matched"
      },
      "source": "https://api.gleif.org/api/v1/lei-records",
      "status": "available"
    },
    "limitations": [
      "Every source searches independently; similarly named records are not asserted to describe the same organization.",
      "Coverage is bounded by the requested result limits and lookback windows, and official records may be revised, delayed, incomplete, or absent.",
      "No OFAC candidate is not sanctions clearance, and any candidate requires review against the current official record, program, and legal authority.",
      "The bundle excludes people, beneficial-ownership inference, OFAC's 50 Percent Rule analysis, credit scoring, and identity or domain-ownership verification."
    ],
    "ofacEntityCandidates": {
      "data": {
        "candidateCount": 0,
        "candidates": [],
        "candidatesReturned": 0,
        "status": "no_candidates_above_threshold"
      },
      "source": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports",
      "status": "available"
    },
    "query": {
      "contractLookbackYears": 5,
      "countryCode": "US",
      "legalName": "Apple Inc.",
      "maxContracts": 5,
      "maxOfacCandidates": 3,
      "maxSecFilings": 25,
      "ofacMinimumScore": 90,
      "secIdentifier": "AAPL",
      "secLookbackDays": 365
    },
    "retrievedAt": "2026-08-13T09:30:00+00:00",
    "secFilingActivity": {
      "data": {
        "filingActivity": {
          "attentionLevel": "none",
          "attentionScore": 0,
          "cik": "0000320193",
          "filingCount": 0,
          "filings": [],
          "name": "Apple Inc.",
          "signals": []
        },
        "resolution": {
          "cik": "0000320193",
          "directoryName": "Apple Inc.",
          "method": "ticker_exact"
        }
      },
      "source": "https://www.sec.gov/files/company_tickers_exchange.json",
      "status": "available"
    },
    "sources": [
      {
        "section": "legalEntity",
        "status": "available",
        "url": "https://api.gleif.org/api/v1/lei-records"
      },
      {
        "section": "federalContracts",
        "status": "available",
        "url": "https://api.usaspending.gov/api/v2/search/spending_by_award/"
      },
      {
        "section": "secFilingActivity",
        "status": "available",
        "url": "https://www.sec.gov/files/company_tickers_exchange.json"
      },
      {
        "section": "ofacEntityCandidates",
        "status": "available",
        "url": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports"
      }
    ],
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.organization-evidence",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Official organization evidence bundle result",
      "properties": {
        "counts": {
          "type": "object"
        },
        "coverage": {
          "type": "object"
        },
        "crossSourceLinkage": {
          "type": "string"
        },
        "disclaimer": {
          "type": "string"
        },
        "federalContracts": {
          "type": "object"
        },
        "legalEntity": {
          "type": "object"
        },
        "limitations": {
          "items": {},
          "type": "array"
        },
        "ofacEntityCandidates": {
          "type": "object"
        },
        "query": {
          "type": "object"
        },
        "retrievedAt": {
          "type": "string"
        },
        "secFilingActivity": {
          "type": "object"
        },
        "sources": {
          "items": {},
          "type": "array"
        },
        "warnings": {
          "items": {},
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.organization-evidence",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### NHTSA vehicle VIN decoder (`data.vin-decode`)

Decode a full 17-character VIN into normalized NHTSA vPIC make, model, year, body, engine, transmission, plant, fuel, and occupancy fields with official source evidence and explicit missing-data semantics.

- Endpoint: `POST https://apiacre.com/v1/data/vin-decode`
- Exact price: `$0.003 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.vin-decode
- Browser checkout: https://apiacre.com/try/data.vin-decode
- Tags: data, nhtsa, vpic, vehicle, vin, official-data, automotive, vehicle-data, decoder

#### Request example

```json
{
  "model_year": 2003,
  "vin": "1HGCM82633A004352"
}
```

#### Input schema

```json
{
  "properties": {
    "model_year": {
      "anyOf": [
        {
          "maximum": 2100,
          "minimum": 1980,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional model-year hint used by NHTSA when VIN encoding is ambiguous",
      "title": "Model Year"
    },
    "vin": {
      "description": "Full 17-character vehicle identification number; letters I, O, and Q are invalid",
      "examples": [
        "1HGCM82633A004352"
      ],
      "maxLength": 17,
      "minLength": 17,
      "pattern": "^[A-HJ-NPR-Z0-9]{17}$",
      "title": "Vin",
      "type": "string"
    }
  },
  "required": [
    "vin"
  ],
  "title": "VinDecodeInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "decode": {
      "apiMessage": "Results returned successfully. NOTE: Any missing decoded values should be interpreted as NHTSA does not have data on the specific variable. Missing value should NOT be interpreted as an indication that a feature or technology is unavailable for a vehicle.",
      "clean": true,
      "errorCodes": [
        0
      ],
      "errorText": "0 - VIN decoded clean. Check Digit (9th position) is correct",
      "status": "clean"
    },
    "decodedFieldCount": 20,
    "limitations": [
      "Missing decoded values mean NHTSA has no data for that variable, not that a feature is absent.",
      "A decode does not establish ownership, title, registration, accident, theft, recall, or vehicle-condition status.",
      "VINs can be linkable vehicle identifiers; do not use this result to identify or profile a person."
    ],
    "missingFields": [
      "series",
      "driveType",
      "fuelTypeSecondary",
      "electrificationLevel",
      "engine.manufacturer",
      "plant.companyName",
      "occupancy.seats",
      "occupancy.seatRows"
    ],
    "modelYearHint": 2003,
    "retrievedAt": "2026-08-12T01:30:00+00:00",
    "source": {
      "attribution": "NHTSA Product Information Catalog and Vehicle Listing (vPIC).",
      "dataset": "vPIC",
      "documentationUrl": "https://vpic.nhtsa.dot.gov/api/",
      "endpointUrl": "https://vpic.nhtsa.dot.gov/api/vehicles/DecodeVinValuesExtended/1HGCM82633A004352?format=json&modelyear=2003",
      "provider": "National Highway Traffic Safety Administration",
      "rateControlNotice": "NHTSA applies automated traffic rate controls; API Acre caches results and does not bypass those controls."
    },
    "vehicle": {
      "bodyClass": "Coupe",
      "doors": 2,
      "driveType": null,
      "electrificationLevel": null,
      "engine": {
        "cylinders": 6,
        "displacementLiters": 2.998832712,
        "horsepower": 240,
        "manufacturer": null,
        "model": "J30A4"
      },
      "fuelTypePrimary": "Gasoline",
      "fuelTypeSecondary": null,
      "make": "HONDA",
      "manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
      "manufacturerId": 988,
      "model": "Accord",
      "modelYear": 2003,
      "occupancy": {
        "grossVehicleWeightRating": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
        "seatRows": null,
        "seats": null
      },
      "plant": {
        "city": "MARYSVILLE",
        "companyName": null,
        "country": "UNITED STATES (USA)",
        "state": "OHIO"
      },
      "series": null,
      "transmission": {
        "speeds": 5,
        "style": "Automatic"
      },
      "trim": "EX-V6",
      "vehicleType": "PASSENGER CAR"
    },
    "vin": "1HGCM82633A004352"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.vin-decode",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured NHTSA vehicle VIN decoder result",
      "properties": {
        "decode": {
          "additionalProperties": false,
          "properties": {
            "apiMessage": {
              "type": [
                "string",
                "null"
              ]
            },
            "clean": {
              "type": "boolean"
            },
            "errorCodes": {
              "items": {
                "minimum": 0,
                "type": "integer"
              },
              "maxItems": 20,
              "type": "array",
              "uniqueItems": true
            },
            "errorText": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "enum": [
                "clean",
                "partial",
                "unresolved"
              ],
              "type": "string"
            }
          },
          "required": [
            "status",
            "clean",
            "errorCodes",
            "errorText",
            "apiMessage"
          ],
          "type": "object"
        },
        "decodedFieldCount": {
          "maximum": 28,
          "minimum": 0,
          "type": "integer"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "maxItems": 3,
          "minItems": 3,
          "type": "array"
        },
        "missingFields": {
          "items": {
            "enum": [
              "make",
              "model",
              "modelYear",
              "manufacturer",
              "manufacturerId",
              "vehicleType",
              "bodyClass",
              "series",
              "trim",
              "doors",
              "driveType",
              "fuelTypePrimary",
              "fuelTypeSecondary",
              "electrificationLevel",
              "engine.cylinders",
              "engine.displacementLiters",
              "engine.horsepower",
              "engine.model",
              "engine.manufacturer",
              "transmission.style",
              "transmission.speeds",
              "plant.city",
              "plant.state",
              "plant.country",
              "plant.companyName",
              "occupancy.seats",
              "occupancy.seatRows",
              "occupancy.grossVehicleWeightRating"
            ],
            "type": "string"
          },
          "maxItems": 28,
          "type": "array",
          "uniqueItems": true
        },
        "modelYearHint": {
          "maximum": 2100,
          "minimum": 1980,
          "type": [
            "integer",
            "null"
          ]
        },
        "retrievedAt": {
          "format": "date-time",
          "type": "string"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "attribution": {
              "type": "string"
            },
            "dataset": {
              "const": "vPIC",
              "type": "string"
            },
            "documentationUrl": {
              "const": "https://vpic.nhtsa.dot.gov/api/",
              "type": "string"
            },
            "endpointUrl": {
              "format": "uri",
              "type": "string"
            },
            "provider": {
              "const": "National Highway Traffic Safety Administration",
              "type": "string"
            },
            "rateControlNotice": {
              "type": "string"
            }
          },
          "required": [
            "provider",
            "dataset",
            "endpointUrl",
            "documentationUrl",
            "attribution",
            "rateControlNotice"
          ],
          "type": "object"
        },
        "vehicle": {
          "additionalProperties": false,
          "properties": {
            "bodyClass": {
              "type": [
                "string",
                "null"
              ]
            },
            "doors": {
              "minimum": 0,
              "type": [
                "number",
                "null"
              ]
            },
            "driveType": {
              "type": [
                "string",
                "null"
              ]
            },
            "electrificationLevel": {
              "type": [
                "string",
                "null"
              ]
            },
            "engine": {
              "additionalProperties": false,
              "properties": {
                "cylinders": {
                  "minimum": 0,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "displacementLiters": {
                  "minimum": 0,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "horsepower": {
                  "minimum": 0,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "manufacturer": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "model": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "cylinders",
                "displacementLiters",
                "horsepower",
                "model",
                "manufacturer"
              ],
              "type": "object"
            },
            "fuelTypePrimary": {
              "type": [
                "string",
                "null"
              ]
            },
            "fuelTypeSecondary": {
              "type": [
                "string",
                "null"
              ]
            },
            "make": {
              "type": [
                "string",
                "null"
              ]
            },
            "manufacturer": {
              "type": [
                "string",
                "null"
              ]
            },
            "manufacturerId": {
              "minimum": 0,
              "type": [
                "integer",
                "null"
              ]
            },
            "model": {
              "type": [
                "string",
                "null"
              ]
            },
            "modelYear": {
              "maximum": 2100,
              "minimum": 1900,
              "type": [
                "integer",
                "null"
              ]
            },
            "occupancy": {
              "additionalProperties": false,
              "properties": {
                "grossVehicleWeightRating": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "seatRows": {
                  "minimum": 0,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "seats": {
                  "minimum": 0,
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "seats",
                "seatRows",
                "grossVehicleWeightRating"
              ],
              "type": "object"
            },
            "plant": {
              "additionalProperties": false,
              "properties": {
                "city": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "companyName": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "country": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "state": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "city",
                "state",
                "country",
                "companyName"
              ],
              "type": "object"
            },
            "series": {
              "type": [
                "string",
                "null"
              ]
            },
            "transmission": {
              "additionalProperties": false,
              "properties": {
                "speeds": {
                  "minimum": 0,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "style": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "style",
                "speeds"
              ],
              "type": "object"
            },
            "trim": {
              "type": [
                "string",
                "null"
              ]
            },
            "vehicleType": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "make",
            "model",
            "modelYear",
            "manufacturer",
            "manufacturerId",
            "vehicleType",
            "bodyClass",
            "series",
            "trim",
            "doors",
            "driveType",
            "fuelTypePrimary",
            "fuelTypeSecondary",
            "electrificationLevel",
            "engine",
            "transmission",
            "plant",
            "occupancy"
          ],
          "type": "object"
        },
        "vin": {
          "maxLength": 17,
          "minLength": 17,
          "pattern": "^[A-HJ-NPR-Z0-9]{17}$",
          "type": "string"
        }
      },
      "required": [
        "vin",
        "modelYearHint",
        "decode",
        "decodedFieldCount",
        "missingFields",
        "vehicle",
        "source",
        "retrievedAt",
        "limitations"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.vin-decode",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### World Bank country indicator snapshot (`data.worldbank-snapshot`)

Bundle six official World Development Indicators into one normalized country snapshot with latest and previous GDP, growth, population, inflation, unemployment, and life-expectancy observations plus source and license evidence.

- Endpoint: `POST https://apiacre.com/v1/data/worldbank-snapshot`
- Exact price: `$0.005 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.worldbank-snapshot
- Browser checkout: https://apiacre.com/try/data.worldbank-snapshot
- Tags: data, world-bank, wdi, country, economy, population, official-data, economic-data, gdp, inflation, unemployment

#### Request example

```json
{
  "country_code": "GBR",
  "lookback_years": 3
}
```

#### Input schema

```json
{
  "properties": {
    "country_code": {
      "description": "ISO 3166-1 alpha-2 or alpha-3 country code",
      "examples": [
        "GBR",
        "US"
      ],
      "maxLength": 3,
      "minLength": 2,
      "pattern": "^[A-Za-z]{2,3}$",
      "title": "Country Code",
      "type": "string"
    },
    "lookback_years": {
      "default": 10,
      "description": "Calendar-year window to request for every fixed indicator",
      "maximum": 20,
      "minimum": 3,
      "title": "Lookback Years",
      "type": "integer"
    }
  },
  "required": [
    "country_code"
  ],
  "title": "WorldBankSnapshotInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "availableMetricCount": 6,
    "country": {
      "capitalCity": "London",
      "incomeLevel": "High income",
      "iso2Code": "GB",
      "iso3Code": "GBR",
      "lendingType": "Not classified",
      "name": "United Kingdom",
      "region": "Europe & Central Asia"
    },
    "license": {
      "attribution": "World Bank, World Development Indicators.",
      "id": "CC-BY-4.0",
      "notice": "Downstream use is subject to the linked dataset terms; preserve this attribution and its acknowledgment requirement, and check indicator metadata for third-party terms.",
      "termsUrl": "https://data.worldbank.org/summary-terms-of-use",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    },
    "limitations": [
      "Latest years vary by indicator and country; inspect each metric's latest year.",
      "Missing or revised observations are reported without interpolation or forecasting.",
      "Official statistics only; not investment, legal, credit, or policy advice."
    ],
    "metrics": {
      "gdpCurrentUsd": {
        "availableObservationCount": 2,
        "indicatorCode": "NY.GDP.MKTP.CD",
        "key": "gdpCurrentUsd",
        "latest": {
          "status": null,
          "value": 4002587541846.01,
          "year": 2025
        },
        "latestDelta": 307048028311.86,
        "name": "GDP (current US$)",
        "observations": [
          {
            "status": null,
            "value": 3695539513534.15,
            "year": 2024
          },
          {
            "status": null,
            "value": 4002587541846.01,
            "year": 2025
          },
          {
            "status": null,
            "value": null,
            "year": 2026
          }
        ],
        "previous": {
          "status": null,
          "value": 3695539513534.15,
          "year": 2024
        },
        "sourceLastUpdated": "2026-07-13",
        "sourceUrl": "https://api.worldbank.org/v2/country/GBR/indicator/NY.GDP.MKTP.CD?format=json&date=2024%3A2026&per_page=100",
        "unit": "current USD"
      },
      "gdpGrowthAnnualPct": {
        "availableObservationCount": 2,
        "indicatorCode": "NY.GDP.MKTP.KD.ZG",
        "key": "gdpGrowthAnnualPct",
        "latest": {
          "status": null,
          "value": 1.38844207858726,
          "year": 2025
        },
        "latestDelta": 0.30816490999945,
        "name": "GDP growth (annual %)",
        "observations": [
          {
            "status": null,
            "value": 1.08027716858781,
            "year": 2024
          },
          {
            "status": null,
            "value": 1.38844207858726,
            "year": 2025
          },
          {
            "status": null,
            "value": null,
            "year": 2026
          }
        ],
        "previous": {
          "status": null,
          "value": 1.08027716858781,
          "year": 2024
        },
        "sourceLastUpdated": "2026-07-13",
        "sourceUrl": "https://api.worldbank.org/v2/country/GBR/indicator/NY.GDP.MKTP.KD.ZG?format=json&date=2024%3A2026&per_page=100",
        "unit": "percent"
      },
      "inflationAnnualPct": {
        "availableObservationCount": 2,
        "indicatorCode": "FP.CPI.TOTL.ZG",
        "key": "inflationAnnualPct",
        "latest": {
          "status": null,
          "value": 3.88306881626,
          "year": 2025
        },
        "latestDelta": 0.6114958699008,
        "name": "Inflation, consumer prices (annual %)",
        "observations": [
          {
            "status": null,
            "value": 3.2715729463592,
            "year": 2024
          },
          {
            "status": null,
            "value": 3.88306881626,
            "year": 2025
          },
          {
            "status": null,
            "value": null,
            "year": 2026
          }
        ],
        "previous": {
          "status": null,
          "value": 3.2715729463592,
          "year": 2024
        },
        "sourceLastUpdated": "2026-07-13",
        "sourceUrl": "https://api.worldbank.org/v2/country/GBR/indicator/FP.CPI.TOTL.ZG?format=json&date=2024%3A2026&per_page=100",
        "unit": "percent"
      },
      "lifeExpectancyYears": {
        "availableObservationCount": 1,
        "indicatorCode": "SP.DYN.LE00.IN",
        "key": "lifeExpectancyYears",
        "latest": {
          "status": null,
          "value": 81.3868536585366,
          "year": 2024
        },
        "latestDelta": null,
        "name": "Life expectancy at birth, total (years)",
        "observations": [
          {
            "status": null,
            "value": 81.3868536585366,
            "year": 2024
          },
          {
            "status": null,
            "value": null,
            "year": 2025
          },
          {
            "status": null,
            "value": null,
            "year": 2026
          }
        ],
        "previous": null,
        "sourceLastUpdated": "2026-07-13",
        "sourceUrl": "https://api.worldbank.org/v2/country/GBR/indicator/SP.DYN.LE00.IN?format=json&date=2024%3A2026&per_page=100",
        "unit": "years"
      },
      "population": {
        "availableObservationCount": 2,
        "indicatorCode": "SP.POP.TOTL",
        "key": "population",
        "latest": {
          "status": null,
          "value": 69487000,
          "year": 2025
        },
        "latestDelta": 206000,
        "name": "Population, total",
        "observations": [
          {
            "status": null,
            "value": 69281000,
            "year": 2024
          },
          {
            "status": null,
            "value": 69487000,
            "year": 2025
          },
          {
            "status": null,
            "value": null,
            "year": 2026
          }
        ],
        "previous": {
          "status": null,
          "value": 69281000,
          "year": 2024
        },
        "sourceLastUpdated": "2026-07-13",
        "sourceUrl": "https://api.worldbank.org/v2/country/GBR/indicator/SP.POP.TOTL?format=json&date=2024%3A2026&per_page=100",
        "unit": "people"
      },
      "unemploymentPct": {
        "availableObservationCount": 2,
        "indicatorCode": "SL.UEM.TOTL.ZS",
        "key": "unemploymentPct",
        "latest": {
          "status": null,
          "value": 4.746,
          "year": 2025
        },
        "latestDelta": 0.385,
        "name": "Unemployment, total (% of total labor force) (modeled ILO estimate)",
        "observations": [
          {
            "status": null,
            "value": 4.361,
            "year": 2024
          },
          {
            "status": null,
            "value": 4.746,
            "year": 2025
          },
          {
            "status": null,
            "value": null,
            "year": 2026
          }
        ],
        "previous": {
          "status": null,
          "value": 4.361,
          "year": 2024
        },
        "sourceLastUpdated": "2026-07-13",
        "sourceUrl": "https://api.worldbank.org/v2/country/GBR/indicator/SL.UEM.TOTL.ZS?format=json&date=2024%3A2026&per_page=100",
        "unit": "percent of total labor force"
      }
    },
    "missingMetrics": [],
    "retrievedAt": "2026-08-12T00:33:37+00:00",
    "source": {
      "apiBaseUrl": "https://api.worldbank.org/v2",
      "countryUrl": "https://api.worldbank.org/v2/country/GBR?format=json",
      "dataset": "World Development Indicators",
      "provider": "World Bank"
    },
    "warnings": [],
    "window": {
      "endYear": 2026,
      "lookbackYears": 3,
      "startYear": 2024
    }
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.worldbank-snapshot",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured World Bank country indicator snapshot result",
      "properties": {
        "availableMetricCount": {
          "maximum": 6,
          "minimum": 1,
          "type": "integer"
        },
        "country": {
          "additionalProperties": false,
          "properties": {
            "capitalCity": {
              "type": [
                "string",
                "null"
              ]
            },
            "incomeLevel": {
              "type": [
                "string",
                "null"
              ]
            },
            "iso2Code": {
              "pattern": "^[A-Z]{2}$",
              "type": [
                "string",
                "null"
              ]
            },
            "iso3Code": {
              "pattern": "^[A-Z]{3}$",
              "type": [
                "string",
                "null"
              ]
            },
            "lendingType": {
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "region": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "iso3Code",
            "iso2Code",
            "name",
            "region",
            "incomeLevel",
            "lendingType",
            "capitalCity"
          ],
          "type": "object"
        },
        "license": {
          "additionalProperties": false,
          "properties": {
            "attribution": {
              "const": "World Bank, World Development Indicators.",
              "type": "string"
            },
            "id": {
              "const": "CC-BY-4.0",
              "type": "string"
            },
            "notice": {
              "type": "string"
            },
            "termsUrl": {
              "const": "https://data.worldbank.org/summary-terms-of-use",
              "type": "string"
            },
            "url": {
              "const": "https://creativecommons.org/licenses/by/4.0/",
              "type": "string"
            }
          },
          "required": [
            "id",
            "url",
            "termsUrl",
            "attribution",
            "notice"
          ],
          "type": "object"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "maxItems": 3,
          "minItems": 3,
          "type": "array"
        },
        "metrics": {
          "additionalProperties": {
            "additionalProperties": false,
            "properties": {
              "availableObservationCount": {
                "maximum": 20,
                "minimum": 0,
                "type": "integer"
              },
              "indicatorCode": {
                "enum": [
                  "NY.GDP.MKTP.CD",
                  "NY.GDP.MKTP.KD.ZG",
                  "SP.POP.TOTL",
                  "FP.CPI.TOTL.ZG",
                  "SL.UEM.TOTL.ZS",
                  "SP.DYN.LE00.IN"
                ],
                "type": "string"
              },
              "key": {
                "enum": [
                  "gdpCurrentUsd",
                  "gdpGrowthAnnualPct",
                  "population",
                  "inflationAnnualPct",
                  "unemploymentPct",
                  "lifeExpectancyYears"
                ],
                "type": "string"
              },
              "latest": {
                "anyOf": [
                  {
                    "additionalProperties": false,
                    "properties": {
                      "status": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "value": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "year": {
                        "maximum": 2100,
                        "minimum": 1900,
                        "type": "integer"
                      }
                    },
                    "required": [
                      "year",
                      "value",
                      "status"
                    ],
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "latestDelta": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "observations": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "status": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "year": {
                      "maximum": 2100,
                      "minimum": 1900,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "year",
                    "value",
                    "status"
                  ],
                  "type": "object"
                },
                "maxItems": 20,
                "type": "array"
              },
              "previous": {
                "anyOf": [
                  {
                    "additionalProperties": false,
                    "properties": {
                      "status": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "value": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "year": {
                        "maximum": 2100,
                        "minimum": 1900,
                        "type": "integer"
                      }
                    },
                    "required": [
                      "year",
                      "value",
                      "status"
                    ],
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "sourceLastUpdated": {
                "format": "date",
                "type": [
                  "string",
                  "null"
                ]
              },
              "sourceUrl": {
                "format": "uri",
                "type": "string"
              },
              "unit": {
                "enum": [
                  "current USD",
                  "percent",
                  "people",
                  "percent of total labor force",
                  "years"
                ],
                "type": "string"
              }
            },
            "required": [
              "key",
              "indicatorCode",
              "name",
              "unit",
              "latest",
              "previous",
              "latestDelta",
              "availableObservationCount",
              "observations",
              "sourceLastUpdated",
              "sourceUrl"
            ],
            "type": "object"
          },
          "maxProperties": 6,
          "minProperties": 1,
          "propertyNames": {
            "enum": [
              "gdpCurrentUsd",
              "gdpGrowthAnnualPct",
              "population",
              "inflationAnnualPct",
              "unemploymentPct",
              "lifeExpectancyYears"
            ]
          },
          "type": "object"
        },
        "missingMetrics": {
          "items": {
            "enum": [
              "gdpCurrentUsd",
              "gdpGrowthAnnualPct",
              "population",
              "inflationAnnualPct",
              "unemploymentPct",
              "lifeExpectancyYears"
            ],
            "type": "string"
          },
          "maxItems": 6,
          "type": "array",
          "uniqueItems": true
        },
        "retrievedAt": {
          "format": "date-time",
          "type": "string"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "apiBaseUrl": {
              "const": "https://api.worldbank.org/v2",
              "type": "string"
            },
            "countryUrl": {
              "format": "uri",
              "type": "string"
            },
            "dataset": {
              "const": "World Development Indicators",
              "type": "string"
            },
            "provider": {
              "const": "World Bank",
              "type": "string"
            }
          },
          "required": [
            "provider",
            "dataset",
            "apiBaseUrl",
            "countryUrl"
          ],
          "type": "object"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "maxItems": 6,
          "type": "array"
        },
        "window": {
          "additionalProperties": false,
          "properties": {
            "endYear": {
              "maximum": 2100,
              "minimum": 1900,
              "type": "integer"
            },
            "lookbackYears": {
              "maximum": 20,
              "minimum": 3,
              "type": "integer"
            },
            "startYear": {
              "maximum": 2100,
              "minimum": 1900,
              "type": "integer"
            }
          },
          "required": [
            "startYear",
            "endYear",
            "lookbackYears"
          ],
          "type": "object"
        }
      },
      "required": [
        "country",
        "window",
        "availableMetricCount",
        "metrics",
        "missingMetrics",
        "warnings",
        "source",
        "license",
        "retrievedAt",
        "limitations"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.worldbank-snapshot",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### SEC filing activity signals (`research.sec-filing-signals`)

Look up a public company by ticker or CIK, normalize recent SEC filings, and flag deterministic events such as late filings, amendments, auditor changes, non-reliance, control changes, or bankruptcy disclosures.

- Endpoint: `POST https://apiacre.com/v1/research/sec-filing-signals`
- Exact price: `$0.05 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.sec-filing-signals
- Browser checkout: https://apiacre.com/try/research.sec-filing-signals
- Tags: research, sec, edgar, company, filings, public-company, due-diligence, risk-signals

#### Request example

```json
{
  "forms": [
    "10-K",
    "10-Q",
    "8-K"
  ],
  "identifier": "AAPL",
  "lookback_days": 365,
  "max_filings": 25
}
```

#### Input schema

```json
{
  "properties": {
    "forms": {
      "description": "Optional exact SEC form filters, such as 10-K, 10-Q, or 8-K",
      "items": {
        "type": "string"
      },
      "maxItems": 30,
      "title": "Forms",
      "type": "array"
    },
    "identifier": {
      "description": "SEC CIK or U.S.-listed ticker symbol",
      "examples": [
        "AAPL",
        "0000320193"
      ],
      "maxLength": 20,
      "minLength": 1,
      "title": "Identifier",
      "type": "string"
    },
    "lookback_days": {
      "default": 365,
      "maximum": 3650,
      "minimum": 30,
      "title": "Lookback Days",
      "type": "integer"
    },
    "max_filings": {
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "title": "Max Filings",
      "type": "integer"
    }
  },
  "required": [
    "identifier"
  ],
  "title": "SecFilingSignalsInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "attentionLevel": "low",
    "attentionScore": 5,
    "cik": "0000320193",
    "disclaimer": "Deterministic filing activity only; not investment, legal, accounting, or credit advice.",
    "exchanges": [
      "Nasdaq"
    ],
    "filingCount": 5,
    "filings": [
      {
        "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/example/filing.htm",
        "filingDate": "2026-01-30",
        "form": "10-Q"
      }
    ],
    "fiscalYearEnd": "0928",
    "lookbackDays": 365,
    "name": "Apple Inc.",
    "retrievedAt": "2026-08-09T00:00:00Z",
    "sic": "3571",
    "sicDescription": "Electronic Computers",
    "signals": [
      {
        "code": "leadership_change",
        "detail": "8-K reports director or principal-officer changes",
        "form": "8-K",
        "item": "5.02",
        "weight": 5
      }
    ],
    "source": "https://data.sec.gov/submissions/CIK0000320193.json",
    "tickers": [
      "AAPL"
    ]
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.sec-filing-signals",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured SEC filing activity signals result",
      "properties": {
        "attentionLevel": {
          "type": "string"
        },
        "attentionScore": {
          "type": "integer"
        },
        "cik": {
          "type": "string"
        },
        "disclaimer": {
          "type": "string"
        },
        "exchanges": {
          "items": {},
          "type": "array"
        },
        "filingCount": {
          "type": "integer"
        },
        "filings": {
          "items": {},
          "type": "array"
        },
        "fiscalYearEnd": {
          "type": "string"
        },
        "lookbackDays": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        },
        "retrievedAt": {
          "type": "string"
        },
        "sic": {
          "type": "string"
        },
        "sicDescription": {
          "type": "string"
        },
        "signals": {
          "items": {},
          "type": "array"
        },
        "source": {
          "type": "string"
        },
        "tickers": {
          "items": {},
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.sec-filing-signals",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### SEC Form 4 insider transactions (`research.sec-insider-transactions`)

Retrieve recent SEC Form 4 officer, director, and 10% beneficial-owner trades for a ticker or CIK, including purchases, sales, awards, exercises, tax withholding, prices, holdings, 10b5-1 context, derivatives, and filing footnotes.

- Endpoint: `POST https://apiacre.com/v1/research/sec-insider-transactions`
- Exact price: `$0.03 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.sec-insider-transactions
- Browser checkout: https://apiacre.com/try/research.sec-insider-transactions
- Tags: research, sec, form-4, insiders, transactions, trades, officers, directors, company, insider, officer, director, beneficial-owner, purchase, sale, ticker, cik, official-data

#### Request example

```json
{
  "identifier": "AAPL",
  "include_derivatives": true,
  "lookback_days": 90,
  "max_filings": 10
}
```

#### Input schema

```json
{
  "properties": {
    "identifier": {
      "description": "SEC CIK or U.S.-listed ticker symbol",
      "examples": [
        "AAPL",
        "0000320193"
      ],
      "maxLength": 20,
      "minLength": 1,
      "title": "Identifier",
      "type": "string"
    },
    "include_derivatives": {
      "default": true,
      "description": "Include option, restricted-stock-unit, and other derivative transactions",
      "title": "Include Derivatives",
      "type": "boolean"
    },
    "lookback_days": {
      "default": 90,
      "maximum": 730,
      "minimum": 1,
      "title": "Lookback Days",
      "type": "integer"
    },
    "max_filings": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "title": "Max Filings",
      "type": "integer"
    }
  },
  "required": [
    "identifier"
  ],
  "title": "SecInsiderTransactionsInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "cik": "0000320193",
    "disclaimer": "Issuer-reported Section 16 ownership data only. Transaction codes and sales do not establish intent or investment merit. Verify filing footnotes; not investment, legal, tax, accounting, or credit advice.",
    "exchanges": [
      "Nasdaq"
    ],
    "filings": [
      {
        "accessionNumber": "0001140361-26-025622",
        "filingDate": "2026-06-17",
        "footnotes": {
          "F2": "Shares withheld by Apple to satisfy tax withholding requirements on vesting of RSUs. No shares were sold."
        },
        "form": "4",
        "is10b5One": false,
        "issuer": {
          "cik": "0000320193",
          "name": "Apple Inc.",
          "ticker": "AAPL"
        },
        "periodOfReport": "2026-06-15",
        "reportDate": "2026-06-15",
        "reportingOwners": [
          {
            "cik": "0001780525",
            "isDirector": false,
            "isOfficer": true,
            "isOther": false,
            "isTenPercentOwner": false,
            "name": "Newstead Jennifer",
            "officerTitle": "SVP, GC and Secretary"
          }
        ],
        "transactionCount": 3,
        "transactions": [
          {
            "acquiredDisposed": "A",
            "code": "M",
            "codeDescription": "exercise or conversion of a derivative security",
            "securityTitle": "Common Stock",
            "securityType": "nonDerivative",
            "shares": 30104,
            "transactionDate": "2026-06-15"
          },
          {
            "acquiredDisposed": "D",
            "code": "F",
            "codeDescription": "payment of exercise price or tax liability with securities",
            "reportedPricePerShare": 296.42,
            "reportedValue": 4813267.96,
            "securityTitle": "Common Stock",
            "securityType": "nonDerivative",
            "shares": 16238,
            "transactionDate": "2026-06-15"
          },
          {
            "acquiredDisposed": "D",
            "code": "M",
            "codeDescription": "exercise or conversion of a derivative security",
            "securityTitle": "Restricted Stock Unit",
            "securityType": "derivative",
            "shares": 30104,
            "transactionDate": "2026-06-15",
            "underlyingSecurityTitle": "Common Stock",
            "underlyingShares": 30104
          }
        ],
        "truncated": false
      }
    ],
    "includeDerivatives": true,
    "lookbackDays": 90,
    "name": "Apple Inc.",
    "retrievedAt": "2026-08-09T00:00:00Z",
    "source": "https://data.sec.gov/submissions/CIK0000320193.json",
    "summary": {
      "codeCounts": {
        "F": 1,
        "M": 2
      },
      "filingCount": 1,
      "openMarketPurchaseReportedValue": 0,
      "openMarketPurchaseShares": 0,
      "openMarketSaleReportedValue": 0,
      "openMarketSaleShares": 0,
      "transactionCount": 3
    },
    "tickers": [
      "AAPL"
    ],
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.sec-insider-transactions",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured SEC Form 4 insider transactions result",
      "properties": {
        "cik": {
          "type": "string"
        },
        "disclaimer": {
          "type": "string"
        },
        "exchanges": {
          "items": {},
          "type": "array"
        },
        "filings": {
          "items": {},
          "type": "array"
        },
        "includeDerivatives": {
          "type": "boolean"
        },
        "lookbackDays": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        },
        "retrievedAt": {
          "type": "string"
        },
        "source": {
          "type": "string"
        },
        "summary": {
          "type": "object"
        },
        "tickers": {
          "items": {},
          "type": "array"
        },
        "warnings": {
          "items": {},
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.sec-insider-transactions",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### SEC normalized financial facts (`research.sec-financial-facts`)

Retrieve normalized, recent issuer-reported revenue, earnings, balance-sheet, cash-flow, and diluted-EPS facts from official SEC XBRL data.

- Endpoint: `POST https://apiacre.com/v1/research/sec-financial-facts`
- Exact price: `$0.02 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.sec-financial-facts
- Browser checkout: https://apiacre.com/try/research.sec-financial-facts
- Tags: research, sec, xbrl, company, financial-data, financial, fundamentals, earnings, official-data

#### Request example

```json
{
  "identifier": "AAPL",
  "metrics": [
    "revenue",
    "net_income",
    "total_assets",
    "diluted_eps"
  ],
  "period_type": "both",
  "periods": 4
}
```

#### Input schema

```json
{
  "properties": {
    "identifier": {
      "description": "SEC CIK or U.S.-listed ticker symbol",
      "examples": [
        "AAPL",
        "0000320193"
      ],
      "maxLength": 20,
      "minLength": 1,
      "title": "Identifier",
      "type": "string"
    },
    "metrics": {
      "description": "Normalized financial metrics to return",
      "items": {
        "enum": [
          "revenue",
          "net_income",
          "operating_income",
          "total_assets",
          "total_liabilities",
          "stockholders_equity",
          "cash_and_equivalents",
          "operating_cash_flow",
          "capital_expenditure",
          "diluted_eps"
        ],
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "title": "Metrics",
      "type": "array"
    },
    "period_type": {
      "default": "both",
      "enum": [
        "annual",
        "quarterly",
        "both"
      ],
      "title": "Period Type",
      "type": "string"
    },
    "periods": {
      "default": 4,
      "description": "Observations per metric",
      "maximum": 12,
      "minimum": 1,
      "title": "Periods",
      "type": "integer"
    }
  },
  "required": [
    "identifier"
  ],
  "title": "SecFinancialFactsInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "cik": "0000320193",
    "disclaimer": "Standardized issuer-reported XBRL facts only; verify filing context before use. Not investment, legal, accounting, or credit advice.",
    "entityName": "Apple Inc.",
    "metrics": {
      "revenue": {
        "concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
        "description": "Revenue from contracts with customers, excluding assessed tax.",
        "label": "Revenue",
        "observations": [
          {
            "accn": "0000320193-25-000079",
            "end": "2025-09-27",
            "filed": "2025-10-31",
            "form": "10-K",
            "fp": "FY",
            "frame": "CY2025",
            "fy": 2025,
            "start": "2024-09-29",
            "val": 416161000000
          }
        ],
        "unit": "USD"
      }
    },
    "missingMetrics": [],
    "periodType": "both",
    "periodsPerMetric": 4,
    "retrievedAt": "2026-08-09T00:00:00Z",
    "source": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json",
    "taxonomy": "us-gaap"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.sec-financial-facts",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured SEC normalized financial facts result",
      "properties": {
        "cik": {
          "type": "string"
        },
        "disclaimer": {
          "type": "string"
        },
        "entityName": {
          "type": "string"
        },
        "metrics": {
          "type": "object"
        },
        "missingMetrics": {
          "items": {},
          "type": "array"
        },
        "periodType": {
          "type": "string"
        },
        "periodsPerMetric": {
          "type": "integer"
        },
        "retrievedAt": {
          "type": "string"
        },
        "source": {
          "type": "string"
        },
        "taxonomy": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.sec-financial-facts",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### SEC public company evidence bundle (`research.sec-company-evidence`)

Resolve an exact SEC company name, ticker, or CIK, then bundle recent filing signals, normalized issuer-reported XBRL facts, and Form 4 insider transactions into one bounded public-company evidence report with explicit section coverage and official-source provenance.

- Endpoint: `POST https://apiacre.com/v1/research/sec-company-evidence`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/research.sec-company-evidence
- Browser checkout: https://apiacre.com/try/research.sec-company-evidence
- Tags: research, sec, edgar, company, filings, xbrl, form-4, due-diligence, official-data, company-search, public-company, financial, insider-transactions

#### Request example

```json
{
  "filing_lookback_days": 365,
  "financial_metrics": [
    "revenue",
    "net_income",
    "total_assets",
    "diluted_eps"
  ],
  "financial_period_type": "both",
  "financial_periods": 4,
  "forms": [
    "10-K",
    "10-Q",
    "8-K"
  ],
  "identifier": "Apple Inc.",
  "include_derivatives": true,
  "insider_lookback_days": 90,
  "max_filings": 25,
  "max_insider_filings": 5
}
```

#### Input schema

```json
{
  "properties": {
    "filing_lookback_days": {
      "default": 365,
      "maximum": 3650,
      "minimum": 30,
      "title": "Filing Lookback Days",
      "type": "integer"
    },
    "financial_metrics": {
      "description": "Normalized issuer-reported financial metrics to include",
      "items": {
        "enum": [
          "revenue",
          "net_income",
          "operating_income",
          "total_assets",
          "total_liabilities",
          "stockholders_equity",
          "cash_and_equivalents",
          "operating_cash_flow",
          "capital_expenditure",
          "diluted_eps"
        ],
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "title": "Financial Metrics",
      "type": "array"
    },
    "financial_period_type": {
      "default": "both",
      "enum": [
        "annual",
        "quarterly",
        "both"
      ],
      "title": "Financial Period Type",
      "type": "string"
    },
    "financial_periods": {
      "default": 4,
      "maximum": 12,
      "minimum": 1,
      "title": "Financial Periods",
      "type": "integer"
    },
    "forms": {
      "description": "Optional exact SEC form filters for the filing-activity section",
      "items": {
        "type": "string"
      },
      "maxItems": 30,
      "title": "Forms",
      "type": "array"
    },
    "identifier": {
      "description": "Exact SEC company name, SEC CIK, or U.S.-listed ticker symbol",
      "examples": [
        "Apple Inc.",
        "AAPL",
        "0000320193"
      ],
      "maxLength": 160,
      "minLength": 1,
      "title": "Identifier",
      "type": "string"
    },
    "include_derivatives": {
      "default": true,
      "description": "Include derivative securities in the Form 4 section",
      "title": "Include Derivatives",
      "type": "boolean"
    },
    "insider_lookback_days": {
      "default": 90,
      "maximum": 730,
      "minimum": 1,
      "title": "Insider Lookback Days",
      "type": "integer"
    },
    "max_filings": {
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "title": "Max Filings",
      "type": "integer"
    },
    "max_insider_filings": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "title": "Max Insider Filings",
      "type": "integer"
    }
  },
  "required": [
    "identifier"
  ],
  "title": "SecCompanyEvidenceInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "company": {
      "cik": "0000320193",
      "exchanges": [
        "Nasdaq"
      ],
      "fiscalYearEnd": "0928",
      "name": "Apple Inc.",
      "sic": "3571",
      "sicDescription": "Electronic Computers",
      "tickers": [
        "AAPL"
      ]
    },
    "coverage": {
      "availableSectionCount": 3,
      "partial": false,
      "requestedSectionCount": 3,
      "sections": {
        "filingActivity": "available",
        "financialFacts": "available",
        "insiderTransactions": "available"
      }
    },
    "disclaimer": "Official SEC evidence normalized for research only; not investment, legal, tax, accounting, credit, sanctions, or compliance advice.",
    "filingActivity": {
      "data": {
        "attentionLevel": "low",
        "attentionScore": 5,
        "cik": "0000320193",
        "filingCount": 5,
        "filings": [
          {
            "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/example/filing.htm",
            "filingDate": "2026-01-30",
            "form": "10-Q"
          }
        ],
        "name": "Apple Inc.",
        "signals": [
          {
            "code": "leadership_change",
            "detail": "8-K reports director or principal-officer changes",
            "form": "8-K",
            "item": "5.02"
          }
        ],
        "source": "https://data.sec.gov/submissions/CIK0000320193.json"
      },
      "status": "available"
    },
    "financialFacts": {
      "data": {
        "cik": "0000320193",
        "entityName": "Apple Inc.",
        "metrics": {
          "revenue": {
            "observations": [
              {
                "end": "2025-09-27",
                "filed": "2025-10-31",
                "form": "10-K",
                "val": 416161000000
              }
            ],
            "unit": "USD"
          }
        },
        "missingMetrics": [],
        "source": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json",
        "taxonomy": "us-gaap"
      },
      "status": "available"
    },
    "insiderTransactions": {
      "data": {
        "cik": "0000320193",
        "filings": [
          {
            "accessionNumber": "0001140361-26-025622",
            "filingDate": "2026-06-17",
            "form": "4",
            "transactionCount": 3
          }
        ],
        "includeDerivatives": true,
        "lookbackDays": 90,
        "name": "Apple Inc.",
        "source": "https://data.sec.gov/submissions/CIK0000320193.json",
        "summary": {
          "codeCounts": {
            "F": 1,
            "M": 2
          },
          "filingCount": 1,
          "transactionCount": 3
        },
        "warnings": []
      },
      "status": "available"
    },
    "limitations": [
      "Coverage is bounded by the requested lookback periods, filing limits, and supported XBRL metrics.",
      "Issuer filings can be amended, restated, delayed, incomplete, or reported under company-specific concepts.",
      "Form 4 transaction codes and footnotes require contextual review and do not establish intent."
    ],
    "parameters": {
      "filingLookbackDays": 365,
      "financialMetrics": [
        "revenue",
        "net_income",
        "total_assets",
        "diluted_eps"
      ],
      "financialPeriodType": "both",
      "financialPeriods": 4,
      "forms": [
        "10-K",
        "10-Q",
        "8-K"
      ],
      "includeDerivatives": true,
      "insiderLookbackDays": 90,
      "maxFilings": 25,
      "maxInsiderFilings": 5
    },
    "resolution": {
      "caveat": "SEC directory coverage and accuracy are not guaranteed. A directory match does not establish ownership, affiliation, identity, or investment merit.",
      "method": "company_name_exact",
      "query": "Apple Inc.",
      "resolvedCik": "0000320193",
      "source": "https://www.sec.gov/files/company_tickers_exchange.json",
      "usedListedCompanyDirectory": true
    },
    "retrievedAt": "2026-08-12T00:00:00Z",
    "sources": [
      "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json",
      "https://data.sec.gov/submissions/CIK0000320193.json",
      "https://www.sec.gov/files/company_tickers_exchange.json"
    ],
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.sec-company-evidence",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured SEC public company evidence bundle result",
      "properties": {
        "company": {
          "type": "object"
        },
        "coverage": {
          "type": "object"
        },
        "disclaimer": {
          "type": "string"
        },
        "filingActivity": {
          "type": "object"
        },
        "financialFacts": {
          "type": "object"
        },
        "insiderTransactions": {
          "type": "object"
        },
        "limitations": {
          "items": {},
          "type": "array"
        },
        "parameters": {
          "type": "object"
        },
        "resolution": {
          "type": "object"
        },
        "retrievedAt": {
          "type": "string"
        },
        "sources": {
          "items": {},
          "type": "array"
        },
        "warnings": {
          "items": {},
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "research.sec-company-evidence",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### US weather forecast (`data.us-weather-forecast`)

Return normalized NOAA/NWS day/night or hourly forecast periods for supported U.S. coordinates, including precipitation probability, humidity, wind, timestamps, source provenance, and explicit coverage limitations.

- Endpoint: `POST https://apiacre.com/v1/data/us-weather-forecast`
- Exact price: `$0.003 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/data.us-weather-forecast
- Browser checkout: https://apiacre.com/try/data.us-weather-forecast
- Tags: data, weather, forecast, nws, noaa, united-states, hourly, official-data, precipitation

#### Request example

```json
{
  "forecast_type": "day_night",
  "latitude": 38.8977,
  "longitude": -77.0365,
  "periods": 2,
  "units": "us"
}
```

#### Input schema

```json
{
  "properties": {
    "forecast_type": {
      "default": "day_night",
      "description": "Day/night forecast periods or hourly forecast periods",
      "enum": [
        "day_night",
        "hourly"
      ],
      "title": "Forecast Type",
      "type": "string"
    },
    "latitude": {
      "description": "Latitude in decimal degrees, rounded to four decimal places",
      "examples": [
        38.8977
      ],
      "maximum": 90,
      "minimum": -90,
      "title": "Latitude",
      "type": "number"
    },
    "longitude": {
      "description": "Longitude in decimal degrees, rounded to four decimal places",
      "examples": [
        -77.0365
      ],
      "maximum": 180,
      "minimum": -180,
      "title": "Longitude",
      "type": "number"
    },
    "periods": {
      "default": 6,
      "description": "Maximum periods to return; day_night supports at most 14 and hourly at most 48",
      "maximum": 48,
      "minimum": 1,
      "title": "Periods",
      "type": "integer"
    },
    "units": {
      "default": "us",
      "description": "US customary or SI units requested from the NWS API",
      "enum": [
        "us",
        "si"
      ],
      "title": "Units",
      "type": "string"
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "title": "UsWeatherForecastInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "forecastType": "day_night",
    "generatedAt": "2026-08-12T03:09:21+00:00",
    "limitations": [
      "Coverage is limited to locations supported by the United States National Weather Service, including supported U.S. territories.",
      "This result contains forecast periods only; it does not include active alerts, current observations, radar, or historical weather.",
      "Internet delivery and timeliness are not guaranteed. For life-safety decisions, check current official alerts and NWS dissemination channels.",
      "Inspect generatedAt, retrievedAt, and local conditions before relying on the forecast."
    ],
    "location": {
      "city": "Washington",
      "grid": {
        "office": "LWX",
        "x": 97,
        "y": 71
      },
      "latitude": 38.8977,
      "longitude": -77.0365,
      "state": "DC",
      "timezone": "America/New_York"
    },
    "periodCount": 2,
    "periods": [
      {
        "detailedForecast": "A slight chance of showers and thunderstorms. Mostly cloudy, with a low around 72. West wind around 5 mph.",
        "dewpoint": {
          "unitCode": "wmoUnit:degC",
          "value": 22.2
        },
        "endTime": "2026-08-12T06:00:00-04:00",
        "isDaytime": false,
        "name": "Tonight",
        "number": 1,
        "probabilityOfPrecipitationPercent": 23,
        "relativeHumidityPercent": 87,
        "shortForecast": "Slight Chance Showers And Thunderstorms",
        "startTime": "2026-08-11T23:00:00-04:00",
        "temperature": 72,
        "temperatureTrend": null,
        "temperatureUnit": "F",
        "windDirection": "W",
        "windSpeed": "5 mph"
      },
      {
        "detailedForecast": "Partly sunny, with a high near 88. Northwest wind around 6 mph.",
        "dewpoint": {
          "unitCode": "wmoUnit:degC",
          "value": 20.6
        },
        "endTime": "2026-08-12T18:00:00-04:00",
        "isDaytime": true,
        "name": "Wednesday",
        "number": 2,
        "probabilityOfPrecipitationPercent": 12,
        "relativeHumidityPercent": 62,
        "shortForecast": "Partly Sunny",
        "startTime": "2026-08-12T06:00:00-04:00",
        "temperature": 88,
        "temperatureTrend": null,
        "temperatureUnit": "F",
        "windDirection": "NW",
        "windSpeed": "6 mph"
      }
    ],
    "periodsTruncated": true,
    "retrievedAt": "2026-08-12T04:10:00+00:00",
    "source": {
      "attribution": "Forecast data: NOAA/National Weather Service.",
      "dataset": "NWS API forecast",
      "disclaimerUrl": "https://www.weather.gov/disclaimer",
      "documentationUrl": "https://www.weather.gov/documentation/services-web-api",
      "forecastUrl": "https://api.weather.gov/gridpoints/LWX/97,71/forecast?units=us",
      "pointsUrl": "https://api.weather.gov/points/38.8977,-77.0365",
      "provider": "NOAA/National Weather Service",
      "transformation": "API Acre normalized selected NWS fields; this response is not an official government product and does not imply NOAA/NWS endorsement.",
      "upstreamAccess": "free open data"
    },
    "units": "us",
    "updatedAt": null
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.us-weather-forecast",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured US weather forecast result",
      "properties": {
        "forecastType": {
          "enum": [
            "day_night",
            "hourly"
          ],
          "type": "string"
        },
        "generatedAt": {
          "format": "date-time",
          "type": [
            "string",
            "null"
          ]
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "maxItems": 4,
          "minItems": 4,
          "type": "array"
        },
        "location": {
          "additionalProperties": false,
          "properties": {
            "city": {
              "maxLength": 200,
              "type": [
                "string",
                "null"
              ]
            },
            "grid": {
              "additionalProperties": false,
              "properties": {
                "office": {
                  "pattern": "^[A-Z]{3}$",
                  "type": "string"
                },
                "x": {
                  "type": "integer"
                },
                "y": {
                  "type": "integer"
                }
              },
              "required": [
                "office",
                "x",
                "y"
              ],
              "type": "object"
            },
            "latitude": {
              "maximum": 90,
              "minimum": -90,
              "type": "number"
            },
            "longitude": {
              "maximum": 180,
              "minimum": -180,
              "type": "number"
            },
            "state": {
              "maxLength": 100,
              "type": [
                "string",
                "null"
              ]
            },
            "timezone": {
              "maxLength": 100,
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "latitude",
            "longitude",
            "city",
            "state",
            "timezone",
            "grid"
          ],
          "type": "object"
        },
        "periodCount": {
          "maximum": 48,
          "minimum": 1,
          "type": "integer"
        },
        "periods": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "detailedForecast": {
                "maxLength": 2000,
                "type": [
                  "string",
                  "null"
                ]
              },
              "dewpoint": {
                "additionalProperties": false,
                "properties": {
                  "unitCode": {
                    "maxLength": 100,
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "value": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "value",
                  "unitCode"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "endTime": {
                "format": "date-time",
                "type": [
                  "string",
                  "null"
                ]
              },
              "isDaytime": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "name": {
                "maxLength": 100,
                "type": [
                  "string",
                  "null"
                ]
              },
              "number": {
                "minimum": 1,
                "type": [
                  "integer",
                  "null"
                ]
              },
              "probabilityOfPrecipitationPercent": {
                "maximum": 100,
                "minimum": 0,
                "type": [
                  "number",
                  "null"
                ]
              },
              "relativeHumidityPercent": {
                "maximum": 100,
                "minimum": 0,
                "type": [
                  "number",
                  "null"
                ]
              },
              "shortForecast": {
                "maxLength": 300,
                "type": [
                  "string",
                  "null"
                ]
              },
              "startTime": {
                "format": "date-time",
                "type": [
                  "string",
                  "null"
                ]
              },
              "temperature": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "temperatureTrend": {
                "maxLength": 50,
                "type": [
                  "string",
                  "null"
                ]
              },
              "temperatureUnit": {
                "enum": [
                  "F",
                  "C",
                  null
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "windDirection": {
                "maxLength": 20,
                "type": [
                  "string",
                  "null"
                ]
              },
              "windSpeed": {
                "maxLength": 100,
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "number",
              "name",
              "startTime",
              "endTime",
              "isDaytime",
              "temperature",
              "temperatureUnit",
              "temperatureTrend",
              "probabilityOfPrecipitationPercent",
              "relativeHumidityPercent",
              "dewpoint",
              "windSpeed",
              "windDirection",
              "shortForecast",
              "detailedForecast"
            ],
            "type": "object"
          },
          "maxItems": 48,
          "minItems": 1,
          "type": "array"
        },
        "periodsTruncated": {
          "type": "boolean"
        },
        "retrievedAt": {
          "format": "date-time",
          "type": "string"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "attribution": {
              "type": "string"
            },
            "dataset": {
              "const": "NWS API forecast",
              "type": "string"
            },
            "disclaimerUrl": {
              "const": "https://www.weather.gov/disclaimer",
              "type": "string"
            },
            "documentationUrl": {
              "const": "https://www.weather.gov/documentation/services-web-api",
              "type": "string"
            },
            "forecastUrl": {
              "format": "uri",
              "pattern": "^https://api\\.weather\\.gov/gridpoints/",
              "type": "string"
            },
            "pointsUrl": {
              "format": "uri",
              "pattern": "^https://api\\.weather\\.gov/points/",
              "type": "string"
            },
            "provider": {
              "const": "NOAA/National Weather Service",
              "type": "string"
            },
            "transformation": {
              "type": "string"
            },
            "upstreamAccess": {
              "const": "free open data",
              "type": "string"
            }
          },
          "required": [
            "provider",
            "dataset",
            "pointsUrl",
            "forecastUrl",
            "documentationUrl",
            "disclaimerUrl",
            "upstreamAccess",
            "attribution",
            "transformation"
          ],
          "type": "object"
        },
        "units": {
          "enum": [
            "us",
            "si"
          ],
          "type": "string"
        },
        "updatedAt": {
          "format": "date-time",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "location",
        "forecastType",
        "units",
        "generatedAt",
        "updatedAt",
        "periodCount",
        "periodsTruncated",
        "periods",
        "source",
        "retrievedAt",
        "limitations"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "data.us-weather-forecast",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### EVM address inspection (`crypto.address-inspect`)

Validate and normalize an Ethereum or EVM wallet address, distinguish valid, absent, or invalid ERC-55 checksum casing, and identify the zero address without a network request.

- Endpoint: `POST https://apiacre.com/v1/crypto/address-inspect`
- Exact price: `$0.002 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.address-inspect
- Browser checkout: https://apiacre.com/try/crypto.address-inspect
- Tags: crypto, evm, ethereum, wallet, address, checksum, erc-55, offline

#### Request example

```json
{
  "address": "0x0000000000000000000000000000000000000000"
}
```

#### Input schema

```json
{
  "properties": {
    "address": {
      "maxLength": 128,
      "minLength": 2,
      "title": "Address",
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "title": "AddressInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "address": "0x0000000000000000000000000000000000000000",
    "bytes": 20,
    "checksumAddress": "0x0000000000000000000000000000000000000000",
    "checksumStatus": "valid",
    "inputCase": "numeric",
    "inputIsChecksum": true,
    "isZero": true,
    "normalizedAddress": "0x0000000000000000000000000000000000000000",
    "reason": null,
    "source": "https://eips.ethereum.org/EIPS/eip-55",
    "valid": true,
    "verification": {
      "balanceChecked": false,
      "chainIndependent": true,
      "contractCodeChecked": false,
      "networkRequestsMade": false,
      "ownershipChecked": false,
      "standard": "ERC-55"
    },
    "warnings": [
      "Zero address detected; do not assume it is an owned or recoverable destination."
    ]
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "address": "$request.address",
          "block_tag": "safe"
        },
        "method": "POST",
        "path": "/v1/crypto/base-account-status",
        "price": "$0.003",
        "reason": "Read one-block Base ETH and native USDC balances, nonce, and contract-code evidence after validating the address.",
        "service": "crypto.base-account-status",
        "title": "Base account status",
        "use_output": "Use the resolved block, ETH and official USDC balances, nonce, and code evidence as a compact Base account status check."
      },
      {
        "authorization_required": true,
        "input_template": {
          "address": "$request.address",
          "block_tag": "safe",
          "token_contracts": []
        },
        "method": "POST",
        "path": "/v1/crypto/base-account-snapshot",
        "price": "$0.01",
        "reason": "Read a one-block Base snapshot with ETH, native USDC, nonce, and contract-code evidence when the buyer needs balances as well as address validation.",
        "service": "crypto.base-account-snapshot",
        "title": "Base account snapshot",
        "use_output": "Use result.data.balances for the native ETH and USDC snapshot; add only explicitly chosen ERC-20 contracts in a separately authorized request."
      },
      {
        "authorization_required": true,
        "input_template": {
          "address": "$request.address",
          "block_tag": "safe",
          "direction": "any",
          "limit": 25,
          "lookback_blocks": 2000
        },
        "method": "POST",
        "path": "/v1/crypto/base-usdc-transfers",
        "price": "$0.005",
        "reason": "Retrieve recent official Base USDC inflows and outflows for the validated address across a bounded block range.",
        "service": "crypto.base-usdc-transfers",
        "title": "Base USDC transfer history",
        "use_output": "Use result.data.transfers as newest-first public event evidence; it is bounded history and does not prove identity, authorization, purpose, or current balance."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.address-inspect",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured EVM address inspection result",
      "properties": {
        "address": {
          "type": "string"
        },
        "bytes": {
          "maximum": 20,
          "minimum": 20,
          "type": [
            "integer",
            "null"
          ]
        },
        "checksumAddress": {
          "pattern": "^0x[0-9a-fA-F]{40}$",
          "type": [
            "string",
            "null"
          ]
        },
        "checksumStatus": {
          "enum": [
            "valid",
            "not_provided",
            "invalid",
            "not_applicable"
          ],
          "type": "string"
        },
        "inputCase": {
          "enum": [
            "lowercase",
            "uppercase",
            "mixed",
            "numeric",
            "invalid"
          ],
          "type": "string"
        },
        "inputIsChecksum": {
          "type": "boolean"
        },
        "isZero": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "normalizedAddress": {
          "pattern": "^0x[0-9a-f]{40}$",
          "type": [
            "string",
            "null"
          ]
        },
        "reason": {
          "type": [
            "string",
            "null"
          ]
        },
        "source": {
          "format": "uri",
          "type": "string"
        },
        "valid": {
          "description": "Whether the input is syntactically a 20-byte hexadecimal EVM address.",
          "type": "boolean"
        },
        "verification": {
          "properties": {
            "balanceChecked": {
              "const": false,
              "type": "boolean"
            },
            "chainIndependent": {
              "const": true,
              "type": "boolean"
            },
            "contractCodeChecked": {
              "const": false,
              "type": "boolean"
            },
            "networkRequestsMade": {
              "const": false,
              "type": "boolean"
            },
            "ownershipChecked": {
              "const": false,
              "type": "boolean"
            },
            "standard": {
              "const": "ERC-55",
              "type": "string"
            }
          },
          "required": [
            "standard",
            "chainIndependent",
            "networkRequestsMade",
            "ownershipChecked",
            "balanceChecked",
            "contractCodeChecked"
          ],
          "type": "object"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.address-inspect",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base account snapshot (`crypto.base-account-snapshot`)

Read point-in-time ETH, native USDC, and up to four caller-selected ERC-20 balances plus account nonce and contract-code status at one resolved Base mainnet block.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-account-snapshot`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-account-snapshot
- Browser checkout: https://apiacre.com/try/crypto.base-account-snapshot
- Tags: crypto, evm, base, ethereum, wallet, address, balance, usdc, erc20, token, portfolio, nonce, contract, onchain

#### Request example

```json
{
  "address": "0x0000000000000000000000000000000000000000",
  "block_tag": "safe",
  "token_contracts": [
    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  ]
}
```

#### Input schema

```json
{
  "properties": {
    "address": {
      "description": "A 20-byte EVM address on Base mainnet",
      "maxLength": 42,
      "minLength": 42,
      "title": "Address",
      "type": "string"
    },
    "block_tag": {
      "default": "safe",
      "description": "Base block tag resolved once and reused for the complete snapshot",
      "enum": [
        "latest",
        "safe",
        "finalized"
      ],
      "title": "Block Tag",
      "type": "string"
    },
    "token_contracts": {
      "description": "Optional caller-selected ERC-20 contracts whose balanceOf, decimals, and symbol methods are read at the same resolved block",
      "items": {
        "type": "string"
      },
      "maxItems": 4,
      "title": "Token Contracts",
      "type": "array"
    }
  },
  "required": [
    "address"
  ],
  "title": "BaseAccountSnapshotInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "address": "0x0000000000000000000000000000000000000000",
    "balances": {
      "eth": {
        "formatted": "0",
        "wei": "0"
      },
      "usdc": {
        "atomic": "0",
        "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "decimals": 6,
        "formatted": "0"
      }
    },
    "block": {
      "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "number": 34567890,
      "requestedTag": "safe",
      "timestamp": "2026-08-10T16:00:00+00:00"
    },
    "codeSizeBytes": 0,
    "disclaimer": "Point-in-time public Base chain state and caller-selected token contracts only. Token metadata is untrusted and optional; no ownership, identity, risk, solvency, portfolio-completeness, or transaction-intent conclusion is provided.",
    "explorerUrl": "https://basescan.org/address/0x0000000000000000000000000000000000000000",
    "hasCode": false,
    "network": "eip155:8453",
    "nonce": 0,
    "requestedTokenCount": 1,
    "source": "https://docs.base.org/base-chain/quickstart/connecting-to-base",
    "tokenSource": "https://eips.ethereum.org/EIPS/eip-20",
    "tokens": [
      {
        "balanceAtomic": "0",
        "balanceFormatted": "0",
        "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "decimals": 6,
        "standard": "ERC-20",
        "status": "ok",
        "symbol": "USDC",
        "warnings": []
      }
    ],
    "usdcSource": "https://developers.circle.com/stablecoins/usdc-contract-addresses"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "address": "$request.address",
          "block_tag": "$request.block_tag",
          "direction": "any",
          "limit": 25,
          "lookback_blocks": 2000
        },
        "method": "POST",
        "path": "/v1/crypto/base-usdc-transfers",
        "price": "$0.005",
        "reason": "Add recent official Base USDC transfer evidence to the point-in-time balance snapshot.",
        "service": "crypto.base-usdc-transfers",
        "title": "Base USDC transfer history",
        "use_output": "Compare bounded events with the snapshot only as point-in-time evidence; neither result is complete transaction history or identity proof."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-account-snapshot",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Base account snapshot result",
      "properties": {
        "address": {
          "type": "string"
        },
        "balances": {
          "type": "object"
        },
        "block": {
          "type": "object"
        },
        "codeSizeBytes": {
          "type": "integer"
        },
        "disclaimer": {
          "type": "string"
        },
        "explorerUrl": {
          "type": "string"
        },
        "hasCode": {
          "type": "boolean"
        },
        "network": {
          "type": "string"
        },
        "nonce": {
          "type": "integer"
        },
        "requestedTokenCount": {
          "type": "integer"
        },
        "source": {
          "type": "string"
        },
        "tokenSource": {
          "type": "string"
        },
        "tokens": {
          "description": "Balances for only the caller-selected token contracts; this is not a discovered or complete portfolio.",
          "items": {
            "properties": {
              "balanceAtomic": {
                "pattern": "^[0-9]+$",
                "type": [
                  "string",
                  "null"
                ]
              },
              "balanceFormatted": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "contract": {
                "pattern": "^0x[0-9a-fA-F]{40}$",
                "type": "string"
              },
              "decimals": {
                "maximum": 255,
                "minimum": 0,
                "type": [
                  "integer",
                  "null"
                ]
              },
              "standard": {
                "const": "ERC-20",
                "type": "string"
              },
              "status": {
                "enum": [
                  "ok",
                  "unavailable"
                ],
                "type": "string"
              },
              "symbol": {
                "maxLength": 64,
                "type": [
                  "string",
                  "null"
                ]
              },
              "warnings": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "required": [
              "contract",
              "standard",
              "status",
              "symbol",
              "decimals",
              "balanceAtomic",
              "balanceFormatted",
              "warnings"
            ],
            "type": "object"
          },
          "maxItems": 4,
          "type": "array"
        },
        "usdcSource": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-account-snapshot",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base account status (`crypto.base-account-status`)

Read ETH and native USDC balances, transaction nonce, and contract-code evidence for one wallet or contract address at a single resolved Base mainnet block.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-account-status`
- Exact price: `$0.003 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-account-status
- Browser checkout: https://apiacre.com/try/crypto.base-account-status
- Tags: crypto, evm, base, ethereum, rpc, wallet, address, account, eth, usdc, stablecoin, balance, nonce, bytecode, contract, onchain, read-only

#### Request example

```json
{
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "block_tag": "safe"
}
```

#### Input schema

```json
{
  "properties": {
    "address": {
      "description": "A 20-byte EVM address on Base mainnet",
      "maxLength": 42,
      "minLength": 42,
      "title": "Address",
      "type": "string"
    },
    "block_tag": {
      "default": "safe",
      "description": "Base block tag resolved once and reused for every account read",
      "enum": [
        "latest",
        "safe",
        "finalized"
      ],
      "title": "Block Tag",
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "title": "BaseAccountStatusInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "block": {
      "hash": "0xbf20a3349486d50cba755d4a64cc4cbc64565c6133b7d25befe760b4331c2a4a",
      "number": 49895352,
      "requestedTag": "safe",
      "timestamp": "2026-08-13T00:14:11+00:00"
    },
    "code": {
      "sha256": "98d785fcb1bf847f287adc2310759fd94cc13e754b974bc72131382e8266f607",
      "sizeBytes": 1852,
      "status": "present"
    },
    "disclaimer": "Point-in-time public Base state only. Empty code does not prove that an address is controlled, safe, active, or permanently an externally owned account; no identity, ownership, portfolio-completeness, solvency, or transaction-intent conclusion is provided.",
    "ethBalance": {
      "formatted": "0.009800646158085843",
      "wei": "9800646158085843"
    },
    "explorerUrl": "https://basescan.org/address/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "network": "eip155:8453",
    "networkRequestsMade": 2,
    "nonce": 1,
    "readOnly": true,
    "source": "https://docs.base.org/base-chain/quickstart/connecting-to-base",
    "transactionBroadcast": false,
    "usdcBalance": {
      "atomic": "0",
      "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "formatted": "0"
    },
    "usdcSource": "https://developers.circle.com/stablecoins/usdc-contract-addresses",
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "authorization_required": true,
        "input_template": {
          "address": "$request.address",
          "block_tag": "safe",
          "token_contracts": []
        },
        "method": "POST",
        "path": "/v1/crypto/base-account-snapshot",
        "price": "$0.01",
        "reason": "Expand the account status into one-block ETH, native USDC, and optional caller-selected ERC-20 balances.",
        "service": "crypto.base-account-snapshot",
        "title": "Base account snapshot",
        "use_output": "Use the richer result when the buyer needs explicitly scoped Base token balances as well as account status."
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-account-status",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Base account status result",
      "properties": {
        "address": {
          "pattern": "^0x[0-9a-fA-F]{40}$",
          "type": "string"
        },
        "block": {
          "type": "object"
        },
        "code": {
          "properties": {
            "sha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": [
                "string",
                "null"
              ]
            },
            "sizeBytes": {
              "minimum": 0,
              "type": "integer"
            },
            "status": {
              "enum": [
                "present",
                "absent"
              ],
              "type": "string"
            }
          },
          "required": [
            "status",
            "sizeBytes",
            "sha256"
          ],
          "type": "object"
        },
        "disclaimer": {
          "type": "string"
        },
        "ethBalance": {
          "properties": {
            "formatted": {
              "pattern": "^[0-9]+(?:\\.[0-9]+)?$",
              "type": "string"
            },
            "wei": {
              "pattern": "^[0-9]+$",
              "type": "string"
            }
          },
          "required": [
            "wei",
            "formatted"
          ],
          "type": "object"
        },
        "explorerUrl": {
          "format": "uri",
          "type": "string"
        },
        "network": {
          "const": "eip155:8453",
          "type": "string"
        },
        "networkRequestsMade": {
          "const": 2,
          "type": "integer"
        },
        "nonce": {
          "minimum": 0,
          "type": "integer"
        },
        "readOnly": {
          "const": true,
          "type": "boolean"
        },
        "source": {
          "format": "uri",
          "type": "string"
        },
        "transactionBroadcast": {
          "const": false,
          "type": "boolean"
        },
        "usdcBalance": {
          "additionalProperties": false,
          "properties": {
            "atomic": {
              "pattern": "^[0-9]+$",
              "type": "string"
            },
            "contract": {
              "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "type": "string"
            },
            "decimals": {
              "const": 6,
              "type": "integer"
            },
            "formatted": {
              "pattern": "^[0-9]+(?:\\.[0-9]+)?$",
              "type": "string"
            }
          },
          "required": [
            "atomic",
            "formatted",
            "decimals",
            "contract"
          ],
          "type": "object"
        },
        "usdcSource": {
          "format": "uri",
          "type": "string"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-account-status",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base USDC transfer history (`crypto.base-usdc-transfers`)

Retrieve newest-first incoming and outgoing Circle USDC Transfer events for one address across a validated, bounded Base mainnet block range.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-usdc-transfers`
- Exact price: `$0.005 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-usdc-transfers
- Browser checkout: https://apiacre.com/try/crypto.base-usdc-transfers
- Tags: crypto, evm, base, ethereum, rpc, wallet, address, usdc, erc-20, transfer, transfers, history, recent, onchain, read-only

#### Request example

```json
{
  "address": "0x1111111111111111111111111111111111111111",
  "block_tag": "safe",
  "direction": "any",
  "limit": 25,
  "lookback_blocks": 2000
}
```

#### Input schema

```json
{
  "properties": {
    "address": {
      "description": "The 20-byte Base mainnet address whose official USDC transfers are read",
      "maxLength": 42,
      "minLength": 42,
      "title": "Address",
      "type": "string"
    },
    "block_tag": {
      "default": "safe",
      "description": "Base block tag resolved once as the inclusive upper bound",
      "enum": [
        "latest",
        "safe",
        "finalized"
      ],
      "title": "Block Tag",
      "type": "string"
    },
    "direction": {
      "default": "any",
      "description": "Return transfers in either direction or restrict the indexed address topic",
      "enum": [
        "any",
        "incoming",
        "outgoing"
      ],
      "title": "Direction",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "Maximum newest-first transfers returned after validation and de-duplication",
      "maximum": 100,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "lookback_blocks": {
      "default": 2000,
      "description": "Inclusive number of resolved Base blocks to scan, capped for RPC reliability",
      "maximum": 2000,
      "minimum": 1,
      "title": "Lookback Blocks",
      "type": "integer"
    }
  },
  "required": [
    "address"
  ],
  "title": "BaseUsdcTransfersInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "address": "0x1111111111111111111111111111111111111111",
    "addressExplorerUrl": "https://basescan.org/address/0x1111111111111111111111111111111111111111",
    "asset": {
      "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "name": "USD Coin",
      "symbol": "USDC"
    },
    "blockRange": {
      "fromBlock": 34565891,
      "requestedLookbackBlocks": 2000,
      "requestedTag": "safe",
      "scannedBlocks": 2000,
      "toBlock": 34567890,
      "toBlockHash": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "toBlockTimestamp": "2026-08-10T16:00:00+00:00"
    },
    "detected": 1,
    "direction": "any",
    "disclaimer": "Public onchain event evidence only. A transfer does not establish identity, ownership, authorization, commercial purpose, compliance status, or current balance.",
    "duplicatesRemoved": 0,
    "eventSignature": "Transfer(address,address,uint256)",
    "limitations": [
      "Only Circle's official native USDC contract on Base mainnet is queried.",
      "The result covers only the resolved bounded block range, not complete account history.",
      "Finality and provider freshness depend on the requested block tag and public Base RPC."
    ],
    "network": "eip155:8453",
    "networkRequestsMade": 2,
    "queriedLogCount": 1,
    "readOnly": true,
    "removedSkipped": 0,
    "returned": 1,
    "rpcCallsMade": 3,
    "source": "https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_getLogs",
    "tokenSource": "https://eips.ethereum.org/EIPS/eip-20",
    "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
    "transactionBroadcast": false,
    "transfers": [
      {
        "amountAtomic": "12500000",
        "amountUsdc": "12.5",
        "blockHash": "0x2222222222222222222222222222222222222222222222222222222222222222",
        "blockNumber": 34567800,
        "direction": "incoming",
        "explorerUrl": "https://basescan.org/tx/0x3333333333333333333333333333333333333333333333333333333333333333",
        "from": "0x2222222222222222222222222222222222222222",
        "logIndex": 7,
        "to": "0x1111111111111111111111111111111111111111",
        "transactionHash": "0x3333333333333333333333333333333333333333333333333333333333333333",
        "transactionIndex": 4
      }
    ],
    "truncated": false,
    "usdcSource": "https://developers.circle.com/stablecoins/usdc-contract-addresses",
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-usdc-transfers",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Base USDC transfer history result",
      "properties": {
        "address": {
          "pattern": "^0x[0-9a-fA-F]{40}$",
          "type": "string"
        },
        "addressExplorerUrl": {
          "format": "uri",
          "type": "string"
        },
        "asset": {
          "additionalProperties": false,
          "properties": {
            "contract": {
              "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "type": "string"
            },
            "decimals": {
              "const": 6,
              "type": "integer"
            },
            "name": {
              "const": "USD Coin",
              "type": "string"
            },
            "symbol": {
              "const": "USDC",
              "type": "string"
            }
          },
          "required": [
            "name",
            "symbol",
            "contract",
            "decimals"
          ],
          "type": "object"
        },
        "blockRange": {
          "additionalProperties": false,
          "properties": {
            "fromBlock": {
              "minimum": 0,
              "type": "integer"
            },
            "requestedLookbackBlocks": {
              "maximum": 2000,
              "minimum": 1,
              "type": "integer"
            },
            "requestedTag": {
              "enum": [
                "latest",
                "safe",
                "finalized"
              ],
              "type": "string"
            },
            "scannedBlocks": {
              "maximum": 2000,
              "minimum": 1,
              "type": "integer"
            },
            "toBlock": {
              "minimum": 0,
              "type": "integer"
            },
            "toBlockHash": {
              "pattern": "^0x[0-9a-f]{64}$",
              "type": "string"
            },
            "toBlockTimestamp": {
              "format": "date-time",
              "type": "string"
            }
          },
          "required": [
            "requestedTag",
            "fromBlock",
            "toBlock",
            "toBlockHash",
            "toBlockTimestamp",
            "requestedLookbackBlocks",
            "scannedBlocks"
          ],
          "type": "object"
        },
        "detected": {
          "minimum": 0,
          "type": "integer"
        },
        "direction": {
          "enum": [
            "any",
            "incoming",
            "outgoing"
          ],
          "type": "string"
        },
        "disclaimer": {
          "type": "string"
        },
        "duplicatesRemoved": {
          "minimum": 0,
          "type": "integer"
        },
        "eventSignature": {
          "const": "Transfer(address,address,uint256)",
          "type": "string"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "network": {
          "const": "eip155:8453",
          "type": "string"
        },
        "networkRequestsMade": {
          "const": 2,
          "type": "integer"
        },
        "queriedLogCount": {
          "minimum": 0,
          "type": "integer"
        },
        "readOnly": {
          "const": true,
          "type": "boolean"
        },
        "removedSkipped": {
          "minimum": 0,
          "type": "integer"
        },
        "returned": {
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "rpcCallsMade": {
          "enum": [
            2,
            3
          ],
          "type": "integer"
        },
        "source": {
          "format": "uri",
          "type": "string"
        },
        "tokenSource": {
          "format": "uri",
          "type": "string"
        },
        "topic0": {
          "const": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "type": "string"
        },
        "transactionBroadcast": {
          "const": false,
          "type": "boolean"
        },
        "transfers": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "amountAtomic": {
                "pattern": "^[0-9]+$",
                "type": "string"
              },
              "amountUsdc": {
                "pattern": "^[0-9]+(?:\\.[0-9]{1,6})?$",
                "type": "string"
              },
              "blockHash": {
                "pattern": "^0x[0-9a-f]{64}$",
                "type": "string"
              },
              "blockNumber": {
                "minimum": 0,
                "type": "integer"
              },
              "direction": {
                "enum": [
                  "incoming",
                  "outgoing",
                  "self"
                ],
                "type": "string"
              },
              "explorerUrl": {
                "format": "uri",
                "type": "string"
              },
              "from": {
                "pattern": "^0x[0-9a-fA-F]{40}$",
                "type": "string"
              },
              "logIndex": {
                "minimum": 0,
                "type": "integer"
              },
              "to": {
                "pattern": "^0x[0-9a-fA-F]{40}$",
                "type": "string"
              },
              "transactionHash": {
                "pattern": "^0x[0-9a-f]{64}$",
                "type": "string"
              },
              "transactionIndex": {
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "blockNumber",
              "blockHash",
              "transactionHash",
              "transactionIndex",
              "logIndex",
              "from",
              "to",
              "direction",
              "amountAtomic",
              "amountUsdc",
              "explorerUrl"
            ],
            "type": "object"
          },
          "maxItems": 100,
          "type": "array"
        },
        "truncated": {
          "type": "boolean"
        },
        "usdcSource": {
          "format": "uri",
          "type": "string"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-usdc-transfers",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base contract event logs (`crypto.base-event-logs`)

Query validated logs from one Base mainnet contract using a required event signature and at least one indexed topic value across a bounded resolved block range.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-event-logs`
- Exact price: `$0.003 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-event-logs
- Browser checkout: https://apiacre.com/try/crypto.base-event-logs
- Tags: crypto, evm, base, ethereum, rpc, contract, event, logs, topics, indexed, onchain, read-only

#### Request example

```json
{
  "block_tag": "safe",
  "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "limit": 25,
  "lookback_blocks": 2000,
  "topics": [
    "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
    null,
    "0x0000000000000000000000001111111111111111111111111111111111111111"
  ]
}
```

#### Input schema

```json
{
  "properties": {
    "block_tag": {
      "default": "safe",
      "description": "Base block tag resolved once as the inclusive upper bound",
      "enum": [
        "latest",
        "safe",
        "finalized"
      ],
      "title": "Block Tag",
      "type": "string"
    },
    "contract": {
      "description": "The 20-byte Base mainnet contract whose event logs are queried",
      "maxLength": 42,
      "minLength": 42,
      "title": "Contract",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "Maximum newest-first validated logs returned",
      "maximum": 100,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "lookback_blocks": {
      "default": 2000,
      "description": "Inclusive number of resolved Base blocks to scan",
      "maximum": 2000,
      "minimum": 1,
      "title": "Lookback Blocks",
      "type": "integer"
    },
    "topics": {
      "description": "One event-signature topic followed by indexed topic values or null wildcards; at least one indexed value after topic zero is required",
      "examples": [
        [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          null,
          "0x0000000000000000000000001111111111111111111111111111111111111111"
        ]
      ],
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "maxItems": 4,
      "minItems": 2,
      "title": "Topics",
      "type": "array"
    }
  },
  "required": [
    "contract",
    "topics"
  ],
  "title": "BaseEventLogsInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "blockRange": {
      "fromBlock": 34565891,
      "requestedLookbackBlocks": 2000,
      "requestedTag": "safe",
      "scannedBlocks": 2000,
      "toBlock": 34567890,
      "toBlockHash": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "toBlockTimestamp": "2026-08-10T16:00:00+00:00"
    },
    "contractExplorerUrl": "https://basescan.org/address/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "detected": 1,
    "disclaimer": "Public logs do not prove identity, ownership, authorization, or state.",
    "duplicatesRemoved": 0,
    "filter": {
      "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        "0x0000000000000000000000001111111111111111111111111111111111111111"
      ]
    },
    "limitations": [
      "Requires topic zero plus at least one indexed topic value.",
      "Covers only the resolved block range, not full contract history.",
      "Payload is ABI-encoded; finality and freshness depend on the tag and RPC provider."
    ],
    "logs": [
      {
        "blockHash": "0x2222222222222222222222222222222222222222222222222222222222222222",
        "blockNumber": 34567800,
        "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "data": {
          "bytes": 32,
          "hex": "0x0000000000000000000000000000000000000000000000000000000000bebc20",
          "returnedBytes": 32,
          "sha256": "1075ad1aeb25e2412faa67043b490dd6375967f6502d383f5a8a85b4e56e92d0",
          "truncated": false
        },
        "explorerUrl": "https://basescan.org/tx/0x3333333333333333333333333333333333333333333333333333333333333333",
        "logIndex": 7,
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x0000000000000000000000002222222222222222222222222222222222222222",
          "0x0000000000000000000000001111111111111111111111111111111111111111"
        ],
        "transactionHash": "0x3333333333333333333333333333333333333333333333333333333333333333",
        "transactionIndex": 4
      }
    ],
    "network": "eip155:8453",
    "networkRequestsMade": 2,
    "queriedLogCount": 1,
    "readOnly": true,
    "removedSkipped": 0,
    "returned": 1,
    "rpcCallsMade": 2,
    "source": "https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_getLogs",
    "transactionBroadcast": false,
    "truncated": false,
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-event-logs",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured Base contract event logs result",
      "properties": {
        "blockRange": {
          "additionalProperties": false,
          "properties": {
            "fromBlock": {
              "minimum": 0,
              "type": "integer"
            },
            "requestedLookbackBlocks": {
              "maximum": 2000,
              "minimum": 1,
              "type": "integer"
            },
            "requestedTag": {
              "enum": [
                "latest",
                "safe",
                "finalized"
              ],
              "type": "string"
            },
            "scannedBlocks": {
              "maximum": 2000,
              "minimum": 1,
              "type": "integer"
            },
            "toBlock": {
              "minimum": 0,
              "type": "integer"
            },
            "toBlockHash": {
              "pattern": "^0x[0-9a-f]{64}$",
              "type": "string"
            },
            "toBlockTimestamp": {
              "format": "date-time",
              "type": "string"
            }
          },
          "required": [
            "requestedTag",
            "fromBlock",
            "toBlock",
            "toBlockHash",
            "toBlockTimestamp",
            "requestedLookbackBlocks",
            "scannedBlocks"
          ],
          "type": "object"
        },
        "contractExplorerUrl": {
          "format": "uri",
          "type": "string"
        },
        "detected": {
          "minimum": 0,
          "type": "integer"
        },
        "disclaimer": {
          "type": "string"
        },
        "duplicatesRemoved": {
          "minimum": 0,
          "type": "integer"
        },
        "filter": {
          "additionalProperties": false,
          "properties": {
            "contract": {
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "topics": {
              "items": {
                "pattern": "^0x[0-9a-f]{64}$",
                "type": [
                  "string",
                  "null"
                ]
              },
              "maxItems": 4,
              "minItems": 2,
              "type": "array"
            }
          },
          "required": [
            "contract",
            "topics"
          ],
          "type": "object"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "maxItems": 3,
          "minItems": 3,
          "type": "array"
        },
        "logs": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "blockHash": {
                "pattern": "^0x[0-9a-f]{64}$",
                "type": "string"
              },
              "blockNumber": {
                "minimum": 0,
                "type": "integer"
              },
              "contract": {
                "pattern": "^0x[0-9a-fA-F]{40}$",
                "type": "string"
              },
              "data": {
                "additionalProperties": false,
                "properties": {
                  "bytes": {
                    "maximum": 1048576,
                    "minimum": 0,
                    "type": "integer"
                  },
                  "hex": {
                    "maxLength": 8194,
                    "pattern": "^0x(?:[0-9a-f]{2})*$",
                    "type": "string"
                  },
                  "returnedBytes": {
                    "maximum": 4096,
                    "minimum": 0,
                    "type": "integer"
                  },
                  "sha256": {
                    "pattern": "^[0-9a-f]{64}$",
                    "type": "string"
                  },
                  "truncated": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "hex",
                  "bytes",
                  "returnedBytes",
                  "truncated",
                  "sha256"
                ],
                "type": "object"
              },
              "explorerUrl": {
                "format": "uri",
                "type": "string"
              },
              "logIndex": {
                "minimum": 0,
                "type": "integer"
              },
              "topics": {
                "items": {
                  "pattern": "^0x[0-9a-f]{64}$",
                  "type": "string"
                },
                "maxItems": 4,
                "minItems": 1,
                "type": "array"
              },
              "transactionHash": {
                "pattern": "^0x[0-9a-f]{64}$",
                "type": "string"
              },
              "transactionIndex": {
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "contract",
              "topics",
              "data",
              "blockNumber",
              "blockHash",
              "transactionHash",
              "transactionIndex",
              "logIndex",
              "explorerUrl"
            ],
            "type": "object"
          },
          "maxItems": 100,
          "type": "array"
        },
        "network": {
          "const": "eip155:8453",
          "type": "string"
        },
        "networkRequestsMade": {
          "const": 2,
          "type": "integer"
        },
        "queriedLogCount": {
          "minimum": 0,
          "type": "integer"
        },
        "readOnly": {
          "const": true,
          "type": "boolean"
        },
        "removedSkipped": {
          "minimum": 0,
          "type": "integer"
        },
        "returned": {
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "rpcCallsMade": {
          "const": 2,
          "type": "integer"
        },
        "source": {
          "format": "uri",
          "type": "string"
        },
        "transactionBroadcast": {
          "const": false,
          "type": "boolean"
        },
        "truncated": {
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "maxItems": 3,
          "type": "array"
        }
      },
      "required": [
        "network",
        "filter",
        "blockRange",
        "queriedLogCount",
        "detected",
        "returned",
        "truncated",
        "duplicatesRemoved",
        "removedSkipped",
        "logs",
        "networkRequestsMade",
        "rpcCallsMade",
        "readOnly",
        "transactionBroadcast",
        "warnings",
        "limitations",
        "contractExplorerUrl",
        "source",
        "disclaimer"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-event-logs",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base transaction gas estimate (`crypto.base-gas-estimate`)

Estimate gas for one Base mainnet transaction context at a resolved block, add a bounded caller-selected buffer, and preserve RPC rejection evidence without signing or broadcasting.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-gas-estimate`
- Exact price: `$0.004 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-gas-estimate
- Browser checkout: https://apiacre.com/try/crypto.base-gas-estimate
- Tags: crypto, evm, base, ethereum, rpc, transaction, gas, estimate, simulation, fee, read-only

#### Request example

```json
{
  "block_tag": "safe",
  "buffer_percent": 20,
  "call_data": "0x70a082310000000000000000000000001111111111111111111111111111111111111111",
  "from_address": "0x1111111111111111111111111111111111111111",
  "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "value_wei": "0"
}
```

#### Input schema

```json
{
  "properties": {
    "block_tag": {
      "default": "safe",
      "description": "Base block tag resolved once before estimation",
      "enum": [
        "latest",
        "safe",
        "finalized"
      ],
      "title": "Block Tag",
      "type": "string"
    },
    "buffer_percent": {
      "default": 20,
      "description": "Bounded percentage added to the RPC estimate for a suggested gas limit",
      "maximum": 50,
      "minimum": 0,
      "title": "Buffer Percent",
      "type": "integer"
    },
    "call_data": {
      "default": "0x",
      "description": "Optional even-length hexadecimal transaction calldata",
      "examples": [
        "0x313ce567"
      ],
      "maxLength": 32770,
      "minLength": 2,
      "title": "Call Data",
      "type": "string"
    },
    "from_address": {
      "description": "The 20-byte Base mainnet sender context; no private key is used",
      "maxLength": 42,
      "minLength": 42,
      "title": "From Address",
      "type": "string"
    },
    "to": {
      "description": "The 20-byte Base mainnet transaction destination",
      "maxLength": 42,
      "minLength": 42,
      "title": "To",
      "type": "string"
    },
    "value_wei": {
      "default": "0",
      "description": "Unsigned ETH value in wei as a canonical decimal string",
      "examples": [
        "0"
      ],
      "maxLength": 78,
      "minLength": 1,
      "title": "Value Wei",
      "type": "string"
    }
  },
  "required": [
    "from_address",
    "to"
  ],
  "title": "BaseGasEstimateInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "block": {
      "baseFeePerGasWei": "500000",
      "gasLimit": 120000000,
      "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "number": 34567890,
      "requestedTag": "safe",
      "timestamp": "2026-08-10T16:00:00+00:00"
    },
    "disclaimer": "Read-only Base mainnet gas estimation only. No transaction is created, signed, submitted, or broadcast.",
    "estimate": {
      "baseFeeComponentWei": "12320000000",
      "bufferCapped": false,
      "bufferPercent": 20,
      "gas": 24640,
      "gasHex": "0x6040",
      "suggestedBaseFeeComponentWei": "14784000000",
      "suggestedGasLimit": 29568,
      "suggestedGasLimitHex": "0x7380"
    },
    "estimationAccepted": true,
    "limitations": [
      "The estimate is state-dependent and does not guarantee later execution.",
      "Base-fee components exclude priority fees, L1 data fees, and other fee components.",
      "Only one existing destination is estimated; contract deployment is not supported."
    ],
    "network": "eip155:8453",
    "networkRequestsMade": 2,
    "readOnly": true,
    "rpcCallsMade": 2,
    "rpcError": null,
    "source": "https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_estimateGas",
    "status": "estimated",
    "transaction": {
      "dataBytes": 36,
      "dataSha256": "2da90680426443e99a57371fef89ebdb0cba7f941eda4e27491a3bd2069ef775",
      "from": "0x1111111111111111111111111111111111111111",
      "selector": "0x70a08231",
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "valueWei": "0"
    },
    "transactionBroadcast": false,
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-gas-estimate",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured Base transaction gas estimate result",
      "properties": {
        "block": {
          "additionalProperties": false,
          "properties": {
            "baseFeePerGasWei": {
              "pattern": "^[0-9]+$",
              "type": "string"
            },
            "gasLimit": {
              "minimum": 21000,
              "type": "integer"
            },
            "hash": {
              "pattern": "^0x[0-9a-f]{64}$",
              "type": "string"
            },
            "number": {
              "minimum": 0,
              "type": "integer"
            },
            "requestedTag": {
              "enum": [
                "latest",
                "safe",
                "finalized"
              ],
              "type": "string"
            },
            "timestamp": {
              "format": "date-time",
              "type": "string"
            }
          },
          "required": [
            "requestedTag",
            "number",
            "hash",
            "timestamp",
            "gasLimit",
            "baseFeePerGasWei"
          ],
          "type": "object"
        },
        "disclaimer": {
          "type": "string"
        },
        "estimate": {
          "additionalProperties": false,
          "properties": {
            "baseFeeComponentWei": {
              "pattern": "^[0-9]+$",
              "type": "string"
            },
            "bufferCapped": {
              "type": "boolean"
            },
            "bufferPercent": {
              "maximum": 50,
              "minimum": 0,
              "type": "integer"
            },
            "gas": {
              "minimum": 1,
              "type": "integer"
            },
            "gasHex": {
              "pattern": "^0x[0-9a-f]+$",
              "type": "string"
            },
            "suggestedBaseFeeComponentWei": {
              "pattern": "^[0-9]+$",
              "type": "string"
            },
            "suggestedGasLimit": {
              "minimum": 1,
              "type": "integer"
            },
            "suggestedGasLimitHex": {
              "pattern": "^0x[0-9a-f]+$",
              "type": "string"
            }
          },
          "required": [
            "gas",
            "gasHex",
            "bufferPercent",
            "suggestedGasLimit",
            "suggestedGasLimitHex",
            "bufferCapped",
            "baseFeeComponentWei",
            "suggestedBaseFeeComponentWei"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "estimationAccepted": {
          "type": "boolean"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "maxItems": 3,
          "minItems": 3,
          "type": "array"
        },
        "network": {
          "const": "eip155:8453",
          "type": "string"
        },
        "networkRequestsMade": {
          "const": 2,
          "type": "integer"
        },
        "readOnly": {
          "const": true,
          "type": "boolean"
        },
        "rpcCallsMade": {
          "const": 2,
          "type": "integer"
        },
        "rpcError": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "type": "integer"
            },
            "dataPreview": {
              "maxLength": 4096,
              "type": [
                "string",
                "null"
              ]
            },
            "dataTruncated": {
              "type": "boolean"
            },
            "message": {
              "maxLength": 300,
              "type": "string"
            }
          },
          "required": [
            "code",
            "message",
            "dataPreview",
            "dataTruncated"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "source": {
          "format": "uri",
          "type": "string"
        },
        "status": {
          "enum": [
            "estimated",
            "rejected"
          ],
          "type": "string"
        },
        "transaction": {
          "additionalProperties": false,
          "properties": {
            "dataBytes": {
              "maximum": 16384,
              "minimum": 0,
              "type": "integer"
            },
            "dataSha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "from": {
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "selector": {
              "pattern": "^0x[0-9a-f]{8}$",
              "type": [
                "string",
                "null"
              ]
            },
            "to": {
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "valueWei": {
              "pattern": "^(?:0|[1-9][0-9]{0,77})$",
              "type": "string"
            }
          },
          "required": [
            "from",
            "to",
            "valueWei",
            "dataBytes",
            "dataSha256",
            "selector"
          ],
          "type": "object"
        },
        "transactionBroadcast": {
          "const": false,
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "maxItems": 3,
          "type": "array"
        }
      },
      "required": [
        "network",
        "status",
        "estimationAccepted",
        "transaction",
        "block",
        "estimate",
        "rpcError",
        "networkRequestsMade",
        "rpcCallsMade",
        "readOnly",
        "transactionBroadcast",
        "warnings",
        "limitations",
        "source",
        "disclaimer"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-gas-estimate",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base network and fee status (`crypto.base-network-status`)

Read the latest Base mainnet block and a bounded EIP-1559 fee history in one RPC batch, including gas utilization and priority-fee percentile samples.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-network-status`
- Exact price: `$0.001 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-network-status
- Browser checkout: https://apiacre.com/try/crypto.base-network-status
- Tags: crypto, evm, base, ethereum, rpc, network, block, gas, fees, eip-1559, read-only

#### Request example

```json
{
  "fee_history_blocks": 5,
  "reward_percentiles": [
    10,
    50,
    90
  ]
}
```

#### Input schema

```json
{
  "properties": {
    "fee_history_blocks": {
      "default": 5,
      "description": "Number of recent Base blocks included in the EIP-1559 fee history",
      "maximum": 20,
      "minimum": 1,
      "title": "Fee History Blocks",
      "type": "integer"
    },
    "reward_percentiles": {
      "description": "Strictly increasing gas-tip percentiles requested from eth_feeHistory",
      "items": {
        "type": "number"
      },
      "maxItems": 5,
      "minItems": 1,
      "title": "Reward Percentiles",
      "type": "array"
    }
  },
  "title": "BaseNetworkStatusInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "disclaimer": "A point-in-time public Base RPC observation, not a fee guarantee or transaction simulation. Values may change before a transaction is submitted.",
    "fees": {
      "gasPriceWei": "1000000",
      "history": {
        "baseFeePerGasWei": [
          "480000",
          "490000",
          "510000",
          "505000",
          "500000"
        ],
        "blockCount": 5,
        "gasUsedRatio": [
          0.42,
          0.51,
          0.48,
          0.56,
          0.45
        ],
        "headAligned": true,
        "newestBlock": 34600000,
        "nextBaseFeePerGasWei": "495000",
        "oldestBlock": 34599996,
        "priorityFeePerGasWei": [
          [
            "100000",
            "500000",
            "1000000"
          ],
          [
            "100000",
            "500000",
            "1000000"
          ],
          [
            "100000",
            "500000",
            "1000000"
          ],
          [
            "100000",
            "500000",
            "1000000"
          ],
          [
            "100000",
            "500000",
            "1000000"
          ]
        ],
        "rewardPercentiles": [
          10,
          50,
          90
        ]
      }
    },
    "latestBlock": {
      "ageSeconds": 2,
      "baseFeePerGasWei": "500000",
      "gasLimit": 120000000,
      "gasUsed": 54000000,
      "gasUtilization": 0.45,
      "hash": "0x4444444444444444444444444444444444444444444444444444444444444444",
      "number": 34600000,
      "parentHash": "0x3333333333333333333333333333333333333333333333333333333333333333",
      "timestamp": "2026-08-11T13:00:00+00:00",
      "transactionCount": 187
    },
    "network": {
      "caip2": "eip155:8453",
      "chainId": 8453,
      "name": "Base Mainnet"
    },
    "networkRequestsMade": 1,
    "observedAt": "2026-08-11T13:00:02+00:00",
    "readOnly": true,
    "source": "https://docs.base.org/base-chain/quickstart/connecting-to-base",
    "transactionBroadcast": false,
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-network-status",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Base network and fee status result",
      "properties": {
        "disclaimer": {
          "type": "string"
        },
        "fees": {
          "type": "object"
        },
        "latestBlock": {
          "type": "object"
        },
        "network": {
          "type": "object"
        },
        "networkRequestsMade": {
          "type": "integer"
        },
        "observedAt": {
          "type": "string"
        },
        "readOnly": {
          "type": "boolean"
        },
        "source": {
          "type": "string"
        },
        "transactionBroadcast": {
          "type": "boolean"
        },
        "warnings": {
          "items": {},
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-network-status",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base block inspection (`crypto.base-block-inspect`)

Inspect one historical Base mainnet block number or resolve a latest, safe, or finalized tag, returning bounded transaction, gas, fee, root, and head-distance evidence.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-block-inspect`
- Exact price: `$0.001 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-block-inspect
- Browser checkout: https://apiacre.com/try/crypto.base-block-inspect
- Tags: crypto, evm, base, ethereum, rpc, block, historical-block, block-height, gas, transactions, finality, read-only

#### Request example

```json
{
  "block_number": 34600000,
  "block_tag": "safe"
}
```

#### Input schema

```json
{
  "properties": {
    "block_number": {
      "anyOf": [
        {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional Base block number as a JSON-safe integer. When provided it takes precedence over block_tag.",
      "examples": [
        34600000
      ],
      "title": "Block Number"
    },
    "block_tag": {
      "default": "safe",
      "description": "Base block tag used only when block_number is omitted",
      "enum": [
        "latest",
        "safe",
        "finalized"
      ],
      "title": "Block Tag",
      "type": "string"
    }
  },
  "title": "BaseBlockInspectInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "block": {
      "ageSeconds": 4,
      "baseFeePerGasWei": "500000",
      "blobGasUsed": 524288,
      "excessBlobGas": 0,
      "explorerUrl": "https://basescan.org/block/34600000",
      "gasLimit": 120000000,
      "gasUsed": 54000000,
      "gasUtilization": 0.45,
      "hash": "0x4444444444444444444444444444444444444444444444444444444444444444",
      "miner": "0x4200000000000000000000000000000000000011",
      "number": 34600000,
      "parentHash": "0x3333333333333333333333333333333333333333333333333333333333333333",
      "roots": {
        "receipts": "0x7777777777777777777777777777777777777777777777777777777777777777",
        "state": "0x6666666666666666666666666666666666666666666666666666666666666666",
        "transactions": "0x5555555555555555555555555555555555555555555555555555555555555555"
      },
      "sizeBytes": 114491,
      "timestamp": "2026-08-11T13:00:00+00:00",
      "transactionCount": 187
    },
    "disclaimer": "A point-in-time RPC observation, not proof of finality beyond the requested provider tag. Public-provider availability, archival depth, and head freshness may vary.",
    "found": true,
    "head": {
      "blockAtOrBeforeHead": true,
      "confirmations": 3,
      "latestNumber": 34600002
    },
    "network": {
      "caip2": "eip155:8453",
      "chainId": 8453,
      "name": "Base Mainnet"
    },
    "networkRequestsMade": 1,
    "observedAt": "2026-08-11T13:00:04+00:00",
    "readOnly": true,
    "request": {
      "blockNumber": 34600000,
      "blockTag": null,
      "fullTransactions": false,
      "mode": "number",
      "rpcSelector": "0x20ff440"
    },
    "rpcCallsMade": 3,
    "source": "https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_getBlockByNumber",
    "transactionBroadcast": false,
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-block-inspect",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "Structured Base block inspection result",
      "properties": {
        "block": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "ageSeconds": {
                  "minimum": 0,
                  "type": "integer"
                },
                "baseFeePerGasWei": {
                  "pattern": "^[0-9]+$",
                  "type": "string"
                },
                "blobGasUsed": {
                  "minimum": 0,
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "excessBlobGas": {
                  "minimum": 0,
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "explorerUrl": {
                  "format": "uri",
                  "pattern": "^https://basescan\\.org/block/[0-9]+$",
                  "type": "string"
                },
                "gasLimit": {
                  "minimum": 1,
                  "type": "integer"
                },
                "gasUsed": {
                  "minimum": 0,
                  "type": "integer"
                },
                "gasUtilization": {
                  "maximum": 1,
                  "minimum": 0,
                  "type": "number"
                },
                "hash": {
                  "pattern": "^0x[0-9a-f]{64}$",
                  "type": "string"
                },
                "miner": {
                  "pattern": "^0x[0-9a-fA-F]{40}$",
                  "type": "string"
                },
                "number": {
                  "minimum": 0,
                  "type": "integer"
                },
                "parentHash": {
                  "pattern": "^0x[0-9a-f]{64}$",
                  "type": "string"
                },
                "roots": {
                  "additionalProperties": false,
                  "properties": {
                    "receipts": {
                      "pattern": "^0x[0-9a-f]{64}$",
                      "type": "string"
                    },
                    "state": {
                      "pattern": "^0x[0-9a-f]{64}$",
                      "type": "string"
                    },
                    "transactions": {
                      "pattern": "^0x[0-9a-f]{64}$",
                      "type": "string"
                    }
                  },
                  "required": [
                    "transactions",
                    "state",
                    "receipts"
                  ],
                  "type": "object"
                },
                "sizeBytes": {
                  "minimum": 0,
                  "type": "integer"
                },
                "timestamp": {
                  "format": "date-time",
                  "type": "string"
                },
                "transactionCount": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "number",
                "hash",
                "parentHash",
                "timestamp",
                "ageSeconds",
                "transactionCount",
                "sizeBytes",
                "gasLimit",
                "gasUsed",
                "gasUtilization",
                "baseFeePerGasWei",
                "blobGasUsed",
                "excessBlobGas",
                "miner",
                "roots",
                "explorerUrl"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "disclaimer": {
          "maxLength": 500,
          "type": "string"
        },
        "found": {
          "type": "boolean"
        },
        "head": {
          "additionalProperties": false,
          "properties": {
            "blockAtOrBeforeHead": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "confirmations": {
              "minimum": 1,
              "type": [
                "integer",
                "null"
              ]
            },
            "latestNumber": {
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "latestNumber",
            "blockAtOrBeforeHead",
            "confirmations"
          ],
          "type": "object"
        },
        "network": {
          "additionalProperties": false,
          "properties": {
            "caip2": {
              "const": "eip155:8453",
              "type": "string"
            },
            "chainId": {
              "const": 8453,
              "type": "integer"
            },
            "name": {
              "const": "Base Mainnet",
              "type": "string"
            }
          },
          "required": [
            "name",
            "caip2",
            "chainId"
          ],
          "type": "object"
        },
        "networkRequestsMade": {
          "const": 1,
          "type": "integer"
        },
        "observedAt": {
          "format": "date-time",
          "type": "string"
        },
        "readOnly": {
          "const": true,
          "type": "boolean"
        },
        "request": {
          "additionalProperties": false,
          "properties": {
            "blockNumber": {
              "maximum": 9007199254740991,
              "minimum": 0,
              "type": [
                "integer",
                "null"
              ]
            },
            "blockTag": {
              "enum": [
                "latest",
                "safe",
                "finalized",
                null
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "fullTransactions": {
              "const": false,
              "type": "boolean"
            },
            "mode": {
              "enum": [
                "number",
                "tag"
              ],
              "type": "string"
            },
            "rpcSelector": {
              "pattern": "^(?:0x[0-9a-f]+|latest|safe|finalized)$",
              "type": "string"
            }
          },
          "required": [
            "mode",
            "blockNumber",
            "blockTag",
            "rpcSelector",
            "fullTransactions"
          ],
          "type": "object"
        },
        "rpcCallsMade": {
          "const": 3,
          "type": "integer"
        },
        "source": {
          "const": "https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_getBlockByNumber",
          "type": "string"
        },
        "transactionBroadcast": {
          "const": false,
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "maxLength": 500,
            "type": "string"
          },
          "maxItems": 2,
          "type": "array"
        }
      },
      "required": [
        "request",
        "network",
        "observedAt",
        "head",
        "found",
        "block",
        "networkRequestsMade",
        "rpcCallsMade",
        "readOnly",
        "transactionBroadcast",
        "warnings",
        "source",
        "disclaimer"
      ],
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-block-inspect",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base contract inspection (`crypto.base-contract-inspect`)

Inspect Base mainnet contract bytecode, common token metadata, and ERC-165, ERC-721, and ERC-1155 interface signals at one resolved block.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-contract-inspect`
- Exact price: `$0.005 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-contract-inspect
- Browser checkout: https://apiacre.com/try/crypto.base-contract-inspect
- Tags: crypto, evm, base, ethereum, contract, introspection, bytecode, token, metadata, erc20, erc165, erc721, erc1155, rpc, read-only, onchain

#### Request example

```json
{
  "block_tag": "safe",
  "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
```

#### Input schema

```json
{
  "properties": {
    "block_tag": {
      "default": "safe",
      "description": "Base block tag resolved once and reused for every inspection read",
      "enum": [
        "latest",
        "safe",
        "finalized"
      ],
      "title": "Block Tag",
      "type": "string"
    },
    "contract": {
      "description": "The 20-byte Base mainnet contract address to inspect",
      "maxLength": 42,
      "minLength": 42,
      "title": "Contract",
      "type": "string"
    }
  },
  "required": [
    "contract"
  ],
  "title": "BaseContractInspectInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "block": {
      "hash": "0x84d697381027abac69728893f2428050d4600473cc00d7e8b8d4ea6365a3656f",
      "number": 49834076,
      "requestedTag": "safe",
      "timestamp": "2026-08-11T14:11:39+00:00"
    },
    "code": {
      "sha256": "98d785fcb1bf847f287adc2310759fd94cc13e754b974bc72131382e8266f607",
      "sizeBytes": 1852
    },
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "disclaimer": "Point-in-time public Base state only. Token methods are optional and untrusted; interface responses are contract claims, not identity, safety, implementation, ownership, or standards-conformance guarantees. Proxy bytecode may describe only the proxy while calls execute against its current implementation.",
    "explorerUrl": "https://basescan.org/address/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "found": true,
    "interfaces": [
      {
        "interfaceId": "0x01ffc9a7",
        "standard": "ERC-165",
        "supported": null
      },
      {
        "interfaceId": "0x80ac58cd",
        "standard": "ERC-721",
        "supported": null
      },
      {
        "interfaceId": "0xd9b67a26",
        "standard": "ERC-1155",
        "supported": null
      }
    ],
    "network": "eip155:8453",
    "networkRequestsMade": 2,
    "readOnly": true,
    "source": "https://docs.base.org/base-chain/quickstart/connecting-to-base",
    "standardSources": {
      "ERC-1155": "https://eips.ethereum.org/EIPS/eip-1155",
      "ERC-165": "https://eips.ethereum.org/EIPS/eip-165",
      "ERC-20": "https://eips.ethereum.org/EIPS/eip-20",
      "ERC-721": "https://eips.ethereum.org/EIPS/eip-721"
    },
    "tokenMetadata": {
      "decimals": 6,
      "name": "USD Coin",
      "status": "complete",
      "symbol": "USDC",
      "totalSupplyAtomic": "4194970321976430",
      "totalSupplyFormatted": "4194970321.97643"
    },
    "transactionBroadcast": false,
    "warnings": [
      "ERC-165 interface support was unavailable or non-standard",
      "ERC-721 interface support was unavailable or non-standard",
      "ERC-1155 interface support was unavailable or non-standard"
    ]
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-contract-inspect",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Base contract inspection result",
      "properties": {
        "block": {
          "properties": {
            "hash": {
              "pattern": "^0x[0-9a-f]{64}$",
              "type": "string"
            },
            "number": {
              "minimum": 0,
              "type": "integer"
            },
            "requestedTag": {
              "enum": [
                "latest",
                "safe",
                "finalized"
              ],
              "type": "string"
            },
            "timestamp": {
              "format": "date-time",
              "type": "string"
            }
          },
          "required": [
            "requestedTag",
            "number",
            "hash",
            "timestamp"
          ],
          "type": "object"
        },
        "code": {
          "properties": {
            "sha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": [
                "string",
                "null"
              ]
            },
            "sizeBytes": {
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "sizeBytes",
            "sha256"
          ],
          "type": "object"
        },
        "contract": {
          "pattern": "^0x[0-9a-fA-F]{40}$",
          "type": "string"
        },
        "disclaimer": {
          "type": "string"
        },
        "explorerUrl": {
          "format": "uri",
          "type": "string"
        },
        "found": {
          "type": "boolean"
        },
        "interfaces": {
          "items": {
            "properties": {
              "interfaceId": {
                "pattern": "^0x[0-9a-f]{8}$",
                "type": "string"
              },
              "standard": {
                "enum": [
                  "ERC-165",
                  "ERC-721",
                  "ERC-1155"
                ],
                "type": "string"
              },
              "supported": {
                "type": [
                  "boolean",
                  "null"
                ]
              }
            },
            "required": [
              "standard",
              "interfaceId",
              "supported"
            ],
            "type": "object"
          },
          "maxItems": 3,
          "minItems": 3,
          "type": "array"
        },
        "network": {
          "const": "eip155:8453",
          "type": "string"
        },
        "networkRequestsMade": {
          "const": 2,
          "type": "integer"
        },
        "readOnly": {
          "const": true,
          "type": "boolean"
        },
        "source": {
          "format": "uri",
          "type": "string"
        },
        "standardSources": {
          "properties": {
            "ERC-1155": {
              "format": "uri",
              "type": "string"
            },
            "ERC-165": {
              "format": "uri",
              "type": "string"
            },
            "ERC-20": {
              "format": "uri",
              "type": "string"
            },
            "ERC-721": {
              "format": "uri",
              "type": "string"
            }
          },
          "required": [
            "ERC-20",
            "ERC-165",
            "ERC-721",
            "ERC-1155"
          ],
          "type": "object"
        },
        "tokenMetadata": {
          "properties": {
            "decimals": {
              "maximum": 255,
              "minimum": 0,
              "type": [
                "integer",
                "null"
              ]
            },
            "name": {
              "maxLength": 64,
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "enum": [
                "complete",
                "partial",
                "unavailable"
              ],
              "type": "string"
            },
            "symbol": {
              "maxLength": 64,
              "type": [
                "string",
                "null"
              ]
            },
            "totalSupplyAtomic": {
              "pattern": "^[0-9]+$",
              "type": [
                "string",
                "null"
              ]
            },
            "totalSupplyFormatted": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "status",
            "name",
            "symbol",
            "decimals",
            "totalSupplyAtomic",
            "totalSupplyFormatted"
          ],
          "type": "object"
        },
        "transactionBroadcast": {
          "const": false,
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-contract-inspect",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base contract read (`crypto.base-contract-read`)

Execute one bounded read-only eth_call against a resolved Base mainnet block, retain call and block evidence, and optionally decode caller-specified ABI output types.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-contract-read`
- Exact price: `$0.005 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-contract-read
- Browser checkout: https://apiacre.com/try/crypto.base-contract-read
- Tags: crypto, evm, base, ethereum, contract, eth-call, rpc, abi, read-only, onchain

#### Request example

```json
{
  "block_tag": "safe",
  "call_data": "0x313ce567",
  "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "gas_limit": 2000000,
  "output_types": [
    "uint8"
  ]
}
```

#### Input schema

```json
{
  "properties": {
    "block_tag": {
      "default": "safe",
      "description": "Base block tag resolved once before executing the read",
      "enum": [
        "latest",
        "safe",
        "finalized"
      ],
      "title": "Block Tag",
      "type": "string"
    },
    "call_data": {
      "description": "ABI-encoded eth_call data, including the function selector",
      "examples": [
        "0x313ce567"
      ],
      "maxLength": 16386,
      "minLength": 2,
      "title": "Call Data",
      "type": "string"
    },
    "contract": {
      "description": "The 20-byte Base mainnet contract address to read",
      "maxLength": 42,
      "minLength": 42,
      "title": "Contract",
      "type": "string"
    },
    "from_address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional msg.sender context; no private key or transaction is used",
      "title": "From Address"
    },
    "gas_limit": {
      "default": 2000000,
      "description": "Bounded execution allowance for the read-only call",
      "maximum": 5000000,
      "minimum": 21000,
      "title": "Gas Limit",
      "type": "integer"
    },
    "output_types": {
      "description": "Optional primitive ABI output types used to decode a successful result; arrays and tuples are intentionally excluded",
      "examples": [
        [
          "uint8"
        ]
      ],
      "items": {
        "type": "string"
      },
      "maxItems": 16,
      "title": "Output Types",
      "type": "array"
    }
  },
  "required": [
    "contract",
    "call_data"
  ],
  "title": "BaseContractReadInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "block": {
      "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "number": 34567890,
      "requestedTag": "safe",
      "timestamp": "2026-08-10T16:00:00+00:00"
    },
    "call": {
      "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "dataBytes": 4,
      "from": null,
      "gasLimit": 2000000,
      "selector": "0x313ce567",
      "valueWei": "0"
    },
    "decodeStatus": "decoded",
    "decodedValues": [
      6
    ],
    "disclaimer": "Read-only public Base mainnet execution at one resolved block. No transaction is created or broadcast, no gas is consumed on-chain, and decoded values depend on the caller-supplied ABI output types.",
    "network": "eip155:8453",
    "outputTypes": [
      "uint8"
    ],
    "readOnly": true,
    "result": {
      "bytes": 32,
      "hex": "0x0000000000000000000000000000000000000000000000000000000000000006",
      "returnedBytes": 32,
      "sha256": "d1ec675902ef1633427ca360b290b0b3045a0d9058ddb5e648b4c3c3224c5c68",
      "truncated": false
    },
    "rpcError": null,
    "source": "https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_call",
    "success": true,
    "transactionBroadcast": false,
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-contract-read",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Base contract read result",
      "properties": {
        "block": {
          "type": "object"
        },
        "call": {
          "properties": {
            "contract": {
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "dataBytes": {
              "maximum": 8192,
              "minimum": 0,
              "type": "integer"
            },
            "from": {
              "type": [
                "string",
                "null"
              ]
            },
            "gasLimit": {
              "maximum": 5000000,
              "minimum": 21000,
              "type": "integer"
            },
            "selector": {
              "pattern": "^0x[0-9a-f]{8}$",
              "type": [
                "string",
                "null"
              ]
            },
            "valueWei": {
              "const": "0",
              "type": "string"
            }
          },
          "required": [
            "contract",
            "from",
            "selector",
            "dataBytes",
            "gasLimit",
            "valueWei"
          ],
          "type": "object"
        },
        "decodeStatus": {
          "enum": [
            "decoded",
            "failed",
            "not_attempted",
            "not_requested",
            "skipped_truncated"
          ],
          "type": "string"
        },
        "decodedValues": {
          "items": {},
          "type": [
            "array",
            "null"
          ]
        },
        "disclaimer": {
          "type": "string"
        },
        "network": {
          "type": "string"
        },
        "outputTypes": {
          "items": {
            "maxLength": 128,
            "type": "string"
          },
          "maxItems": 16,
          "type": "array"
        },
        "readOnly": {
          "type": "boolean"
        },
        "result": {
          "properties": {
            "bytes": {
              "minimum": 0,
              "type": "integer"
            },
            "hex": {
              "pattern": "^0x(?:[0-9a-f]{2})*$",
              "type": "string"
            },
            "returnedBytes": {
              "maximum": 65536,
              "minimum": 0,
              "type": "integer"
            },
            "sha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "type": [
            "object",
            "null"
          ]
        },
        "rpcError": {
          "properties": {
            "code": {
              "type": "integer"
            },
            "dataPreview": {
              "maxLength": 4096,
              "type": [
                "string",
                "null"
              ]
            },
            "dataTruncated": {
              "type": "boolean"
            },
            "message": {
              "maxLength": 300,
              "type": "string"
            }
          },
          "type": [
            "object",
            "null"
          ]
        },
        "source": {
          "type": "string"
        },
        "success": {
          "type": "boolean"
        },
        "transactionBroadcast": {
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-contract-read",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Base transaction inspection (`crypto.base-transaction-inspect`)

Inspect a Base mainnet transaction and receipt together, including execution outcome, confirmations, actual fee, recognized calldata, and bounded ERC-20-shaped transfer events with official Base USDC recognition.

- Endpoint: `POST https://apiacre.com/v1/crypto/base-transaction-inspect`
- Exact price: `$0.005 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.base-transaction-inspect
- Browser checkout: https://apiacre.com/try/crypto.base-transaction-inspect
- Tags: crypto, evm, base, ethereum, transaction, receipt, confirmations, gas, fees, erc20, usdc, transfers, onchain

#### Request example

```json
{
  "transaction_hash": "0x2222222222222222222222222222222222222222222222222222222222222222"
}
```

#### Input schema

```json
{
  "properties": {
    "transaction_hash": {
      "description": "A 32-byte Base mainnet transaction hash",
      "examples": [
        "0x1212121212121212121212121212121212121212121212121212121212121212"
      ],
      "title": "Transaction Hash",
      "type": "string"
    }
  },
  "required": [
    "transaction_hash"
  ],
  "title": "BaseTransactionInspectInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "block": {
      "confirmations": 5,
      "hash": "0x3333333333333333333333333333333333333333333333333333333333333333",
      "number": 34567890,
      "timestamp": "2026-08-10T16:00:00+00:00",
      "transactionIndex": 7
    },
    "disclaimer": "Public Base mainnet execution data only; no identity, ownership, intent, counterparty quality, or transaction-safety conclusion is provided.",
    "explorerUrl": "https://basescan.org/tx/0x2222222222222222222222222222222222222222222222222222222222222222",
    "found": true,
    "mined": true,
    "network": "eip155:8453",
    "observedAtBlock": 34567894,
    "outcome": "success",
    "receipt": {
      "actualFee": {
        "eth": "0.00000051234",
        "wei": "512340000000"
      },
      "contractAddress": null,
      "cumulativeGasUsed": 2100000,
      "effectiveGasPriceWei": "10000000",
      "gasUsed": 51234,
      "logsCount": 1,
      "outcome": "success",
      "status": 1,
      "tokenTransfers": {
        "detected": 1,
        "eventSignature": "Transfer(address,address,uint256)",
        "events": [
          {
            "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
            "from": "0x1111111111111111111111111111111111111111",
            "logIndex": 12,
            "officialBaseUsdc": true,
            "to": "0x2222222222222222222222222222222222222222",
            "valueAtomic": "42000000",
            "valueFormatted": "42"
          }
        ],
        "limitations": [
          "Only logs with exactly three topics and one 32-byte value are decoded; ERC-721 Transfer logs are excluded.",
          "Non-USDC token metadata, decimals, and ERC-20 conformance are not queried; their values remain atomic."
        ],
        "method": "receipt log shape only; no token contract calls",
        "officialBaseUsdcDetected": 1,
        "returned": 1,
        "source": "https://eips.ethereum.org/EIPS/eip-20",
        "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "truncated": false
      }
    },
    "source": "https://docs.base.org/base-chain/quickstart/connecting-to-base",
    "transaction": {
      "from": "0x1111111111111111111111111111111111111111",
      "gasLimit": 65000,
      "gasPriceWei": "10000000",
      "inputBytes": 68,
      "maxFeePerGasWei": "20000000",
      "maxPriorityFeePerGasWei": "1000000",
      "methodSelector": "0xa9059cbb",
      "nonce": 42,
      "standardCall": {
        "candidateSignatures": [
          "transfer(address,uint256)"
        ],
        "decode": {
          "arguments": [
            {
              "index": 0,
              "type": "address",
              "value": "0x1111111111111111111111111111111111111111"
            },
            {
              "index": 1,
              "type": "uint256",
              "value": 42
            }
          ],
          "canonicalSignature": "transfer(address,uint256)",
          "encoding": {
            "argumentBytes": 64,
            "argumentsSha256": "d3458da251349437abe3549042a49868dc5528422a63bb815f3e0b46725052c9",
            "calldataBytes": 68,
            "calldataSha256": "f77b5da6ef3efa41f5084d653dc4a135a3978d541db97ce13225bd442b025198",
            "canonical": true
          },
          "function": "transfer",
          "inputMode": "selector_and_arguments",
          "resolution": {
            "builtInSignatureCount": 29,
            "candidateCount": 1,
            "candidates": [
              "transfer(address,uint256)"
            ],
            "matchedStandards": [
              "ERC-20"
            ],
            "method": "built_in_standard",
            "networkRequestsMade": false,
            "registryComplete": false,
            "signatureProvided": false,
            "standardReferences": [
              {
                "standard": "ERC-20",
                "url": "https://eips.ethereum.org/EIPS/eip-20"
              }
            ],
            "version": "apiacre-standard-selectors/1"
          },
          "selector": "0xa9059cbb",
          "selectorPresent": true,
          "signature": "transfer(address,uint256)",
          "signatureSource": "built_in_standard",
          "types": [
            "address",
            "uint256"
          ],
          "values": [
            "0x1111111111111111111111111111111111111111",
            42
          ],
          "warnings": [
            "Selector resolution is limited to 29 published standard signatures; four-byte selectors are not globally unique."
          ]
        },
        "selector": "0xa9059cbb",
        "status": "decoded"
      },
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "type": 2,
      "value": {
        "eth": "0",
        "wei": "0"
      }
    },
    "transactionHash": "0x2222222222222222222222222222222222222222222222222222222222222222"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-transaction-inspect",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Base transaction inspection result",
      "properties": {
        "block": {
          "type": [
            "object",
            "null"
          ]
        },
        "disclaimer": {
          "type": "string"
        },
        "explorerUrl": {
          "format": "uri",
          "type": "string"
        },
        "found": {
          "type": "boolean"
        },
        "mined": {
          "type": "boolean"
        },
        "network": {
          "const": "eip155:8453",
          "type": "string"
        },
        "observedAtBlock": {
          "minimum": 0,
          "type": "integer"
        },
        "outcome": {
          "enum": [
            "success",
            "reverted",
            "pending",
            "not_found"
          ],
          "type": "string"
        },
        "receipt": {
          "properties": {
            "actualFee": {
              "type": "object"
            },
            "contractAddress": {
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": [
                "string",
                "null"
              ]
            },
            "cumulativeGasUsed": {
              "minimum": 0,
              "type": "integer"
            },
            "effectiveGasPriceWei": {
              "pattern": "^[0-9]+$",
              "type": "string"
            },
            "gasUsed": {
              "minimum": 0,
              "type": "integer"
            },
            "logsCount": {
              "minimum": 0,
              "type": "integer"
            },
            "outcome": {
              "enum": [
                "success",
                "reverted"
              ],
              "type": "string"
            },
            "status": {
              "enum": [
                0,
                1
              ],
              "type": "integer"
            },
            "tokenTransfers": {
              "properties": {
                "detected": {
                  "minimum": 0,
                  "type": "integer"
                },
                "eventSignature": {
                  "const": "Transfer(address,address,uint256)",
                  "type": "string"
                },
                "events": {
                  "items": {
                    "properties": {
                      "contract": {
                        "pattern": "^0x[0-9a-fA-F]{40}$",
                        "type": "string"
                      },
                      "from": {
                        "pattern": "^0x[0-9a-fA-F]{40}$",
                        "type": "string"
                      },
                      "logIndex": {
                        "minimum": 0,
                        "type": "integer"
                      },
                      "officialBaseUsdc": {
                        "type": "boolean"
                      },
                      "to": {
                        "pattern": "^0x[0-9a-fA-F]{40}$",
                        "type": "string"
                      },
                      "valueAtomic": {
                        "pattern": "^[0-9]+$",
                        "type": "string"
                      },
                      "valueFormatted": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "logIndex",
                      "contract",
                      "from",
                      "to",
                      "valueAtomic",
                      "officialBaseUsdc",
                      "valueFormatted"
                    ],
                    "type": "object"
                  },
                  "maxItems": 100,
                  "type": "array"
                },
                "limitations": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "method": {
                  "type": "string"
                },
                "officialBaseUsdcDetected": {
                  "minimum": 0,
                  "type": "integer"
                },
                "returned": {
                  "maximum": 100,
                  "minimum": 0,
                  "type": "integer"
                },
                "source": {
                  "format": "uri",
                  "type": "string"
                },
                "topic0": {
                  "const": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                  "type": "string"
                },
                "truncated": {
                  "type": "boolean"
                }
              },
              "required": [
                "eventSignature",
                "topic0",
                "detected",
                "returned",
                "truncated",
                "officialBaseUsdcDetected",
                "events",
                "method",
                "source",
                "limitations"
              ],
              "type": "object"
            }
          },
          "type": [
            "object",
            "null"
          ]
        },
        "source": {
          "format": "uri",
          "type": "string"
        },
        "transaction": {
          "type": [
            "object",
            "null"
          ]
        },
        "transactionHash": {
          "pattern": "^0x[0-9a-f]{64}$",
          "type": "string"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.base-transaction-inspect",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Calldata decoder (`crypto.calldata-decode`)

Resolve 29 common ERC-20, ERC-165, ERC-721, ERC-1155, ERC-2612, and ERC-3009 selectors without a network lookup, or strictly decode arbitrary Ethereum or EVM calldata using a supplied Solidity signature.

- Endpoint: `POST https://apiacre.com/v1/crypto/calldata-decode`
- Exact price: `$0.001 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.calldata-decode
- Browser checkout: https://apiacre.com/try/crypto.calldata-decode
- Tags: crypto, evm, ethereum, solidity, calldata, abi, decode, selector, canonical

#### Request example

```json
{
  "calldata": "0xa9059cbb0000000000000000000000001111111111111111111111111111111111111111000000000000000000000000000000000000000000000000000000000000002a",
  "input_mode": "auto"
}
```

#### Input schema

```json
{
  "properties": {
    "calldata": {
      "description": "ABI argument bytes, optionally prefixed by the four-byte function selector",
      "maxLength": 200000,
      "minLength": 2,
      "title": "Calldata",
      "type": "string"
    },
    "function_signature": {
      "anyOf": [
        {
          "maxLength": 500,
          "minLength": 3,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional Solidity function signature, including argument types but no parameter names. When omitted, calldata must include a selector from the bounded built-in ERC-20, ERC-165, ERC-721, ERC-1155, ERC-2612, or ERC-3009 set.",
      "examples": [
        "transfer(address,uint256)"
      ],
      "title": "Function Signature"
    },
    "input_mode": {
      "default": "auto",
      "description": "Whether calldata includes a selector. Auto consumes a matching supplied-signature selector, or resolves a built-in standard selector when function_signature is omitted.",
      "enum": [
        "auto",
        "selector_and_arguments",
        "arguments_only"
      ],
      "title": "Input Mode",
      "type": "string"
    }
  },
  "required": [
    "calldata"
  ],
  "title": "CalldataInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "arguments": [
      {
        "index": 0,
        "type": "address",
        "value": "0x1111111111111111111111111111111111111111"
      },
      {
        "index": 1,
        "type": "uint256",
        "value": 42
      }
    ],
    "canonicalSignature": "transfer(address,uint256)",
    "encoding": {
      "argumentBytes": 64,
      "argumentsSha256": "d3458da251349437abe3549042a49868dc5528422a63bb815f3e0b46725052c9",
      "calldataBytes": 68,
      "calldataSha256": "f77b5da6ef3efa41f5084d653dc4a135a3978d541db97ce13225bd442b025198",
      "canonical": true
    },
    "function": "transfer",
    "inputMode": "selector_and_arguments",
    "resolution": {
      "builtInSignatureCount": 29,
      "candidateCount": 1,
      "candidates": [
        "transfer(address,uint256)"
      ],
      "matchedStandards": [
        "ERC-20"
      ],
      "method": "built_in_standard",
      "networkRequestsMade": false,
      "registryComplete": false,
      "signatureProvided": false,
      "standardReferences": [
        {
          "standard": "ERC-20",
          "url": "https://eips.ethereum.org/EIPS/eip-20"
        }
      ],
      "version": "apiacre-standard-selectors/1"
    },
    "selector": "0xa9059cbb",
    "selectorPresent": true,
    "signature": "transfer(address,uint256)",
    "signatureSource": "built_in_standard",
    "types": [
      "address",
      "uint256"
    ],
    "values": [
      "0x1111111111111111111111111111111111111111",
      42
    ],
    "warnings": [
      "Selector resolution is limited to 29 published standard signatures; four-byte selectors are not globally unique."
    ]
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.calldata-decode",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured Calldata decoder result",
      "properties": {
        "arguments": {
          "items": {
            "properties": {
              "index": {
                "maximum": 63,
                "minimum": 0,
                "type": "integer"
              },
              "type": {
                "type": "string"
              },
              "value": {}
            },
            "required": [
              "index",
              "type",
              "value"
            ],
            "type": "object"
          },
          "maxItems": 64,
          "type": "array"
        },
        "canonicalSignature": {
          "pattern": "^[A-Za-z_][A-Za-z0-9_]*\\(.*\\)$",
          "type": "string"
        },
        "encoding": {
          "properties": {
            "argumentBytes": {
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            },
            "argumentsSha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "calldataBytes": {
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            },
            "calldataSha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "canonical": {
              "const": true,
              "type": "boolean"
            }
          },
          "required": [
            "calldataBytes",
            "argumentBytes",
            "calldataSha256",
            "argumentsSha256",
            "canonical"
          ],
          "type": "object"
        },
        "function": {
          "type": "string"
        },
        "inputMode": {
          "enum": [
            "selector_and_arguments",
            "arguments_only"
          ],
          "type": "string"
        },
        "resolution": {
          "properties": {
            "builtInSignatureCount": {
              "const": 29,
              "type": "integer"
            },
            "candidateCount": {
              "minimum": 1,
              "type": "integer"
            },
            "candidates": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "matchedStandards": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "method": {
              "enum": [
                "caller_supplied",
                "built_in_standard"
              ],
              "type": "string"
            },
            "networkRequestsMade": {
              "const": false,
              "type": "boolean"
            },
            "registryComplete": {
              "const": false,
              "type": "boolean"
            },
            "signatureProvided": {
              "type": "boolean"
            },
            "standardReferences": {
              "items": {
                "properties": {
                  "standard": {
                    "type": "string"
                  },
                  "url": {
                    "format": "uri",
                    "type": "string"
                  }
                },
                "required": [
                  "standard",
                  "url"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "version": {
              "const": "apiacre-standard-selectors/1",
              "type": "string"
            }
          },
          "required": [
            "method",
            "signatureProvided",
            "candidateCount",
            "candidates",
            "matchedStandards",
            "standardReferences",
            "builtInSignatureCount",
            "registryComplete",
            "networkRequestsMade",
            "version"
          ],
          "type": "object"
        },
        "selector": {
          "pattern": "^0x[0-9a-f]{8}$",
          "type": "string"
        },
        "selectorPresent": {
          "type": "boolean"
        },
        "signature": {
          "type": "string"
        },
        "signatureSource": {
          "enum": [
            "caller_supplied",
            "built_in_standard"
          ],
          "type": "string"
        },
        "types": {
          "items": {
            "type": "string"
          },
          "maxItems": 64,
          "type": "array"
        },
        "values": {
          "items": {},
          "maxItems": 64,
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.calldata-decode",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```

### EIP-712 hash (`crypto.typed-data-hash`)

Validate EIP-712 typed structured data and derive its domain separator, message hash, and signing digest.

- Endpoint: `POST https://apiacre.com/v1/crypto/typed-data-hash`
- Exact price: `$0.01 USDC`
- Network: `eip155:8453`
- Documentation: https://apiacre.com/services/crypto.typed-data-hash
- Browser checkout: https://apiacre.com/try/crypto.typed-data-hash
- Tags: crypto, evm, ethereum, eip-712, typed-data, hash

#### Request example

```json
{
  "typed_data": {
    "domain": {
      "name": "API Acre Example"
    },
    "message": {
      "contents": "Hello"
    },
    "primaryType": "Message",
    "types": {
      "EIP712Domain": [
        {
          "name": "name",
          "type": "string"
        }
      ],
      "Message": [
        {
          "name": "contents",
          "type": "string"
        }
      ]
    }
  }
}
```

#### Input schema

```json
{
  "properties": {
    "typed_data": {
      "additionalProperties": true,
      "title": "Typed Data",
      "type": "object"
    }
  },
  "required": [
    "typed_data"
  ],
  "title": "TypedDataInput",
  "type": "object"
}
```

#### Response example

```json
{
  "data": {
    "domainSeparator": "0xc167959bdf834486717879a8cd6eb3e12a864d1b1d7dbcecec40455e1b4bc8c8",
    "messageHash": "0xd6a9eadbfb49313d8b83d02d2bb22b916a5b16e6006946c9ca6fa7959d934b3a",
    "primaryType": "Message",
    "signingHash": "0x7433e410d5f2857cb42d0bfd31bc71e8aa553f02ce0eed397927f01dfb46424c",
    "valid": true
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.typed-data-hash",
  "version": "1"
}
```

#### Output schema

```json
{
  "properties": {
    "data": {
      "description": "Structured EIP-712 hash result",
      "properties": {
        "domainSeparator": {
          "type": "string"
        },
        "messageHash": {
          "type": "string"
        },
        "primaryType": {
          "type": "string"
        },
        "signingHash": {
          "type": "string"
        },
        "valid": {
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "meta": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "duration_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_actions": {
          "description": "Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.",
          "items": {
            "properties": {
              "authorization_required": {
                "const": true,
                "type": "boolean"
              },
              "input_template": {
                "description": "Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.",
                "type": "object"
              },
              "method": {
                "const": "POST",
                "type": "string"
              },
              "path": {
                "pattern": "^/v1/",
                "type": "string"
              },
              "price": {
                "pattern": "^\\$[0-9]+",
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "service": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "use_output": {
                "type": "string"
              }
            },
            "required": [
              "service",
              "title",
              "reason",
              "method",
              "path",
              "price",
              "input_template",
              "use_output",
              "authorization_required"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "duration_ms",
        "cached",
        "sources",
        "warnings",
        "next_actions"
      ],
      "type": "object"
    },
    "request_id": {
      "description": "Unique request identifier",
      "type": "string"
    },
    "service": {
      "const": "crypto.typed-data-hash",
      "type": "string"
    },
    "version": {
      "const": "1",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "service",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}
```