{
  "prices_usdc": {
    "composite": "0.025",
    "atomic": "0.005"
  },
  "totals": {
    "suites": 10,
    "endpoints": 100,
    "composites": 20,
    "atomics": 80
  },
  "suites": [
    {
      "id": "api",
      "wave": 1,
      "name": "Web Intelligence",
      "tagline": "Company intel, lead verification, URL-to-markdown, SEO X-ray, MX forensics and sitemap crawling.",
      "host": "api.caelaralabs.com",
      "title": "Caelara Labs API Suite",
      "endpoints": [
        {
          "path": "/v1/company-intel-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Company intelligence: web metadata + DNS + MX in one call",
          "params": [
            {
              "name": "domain",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Company domain, e.g. example.com"
            }
          ]
        },
        {
          "path": "/v1/lead-verify-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Lead verification: email deliverability signals + LinkedIn URL checks",
          "params": [
            {
              "name": "email",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Lead email address"
            },
            {
              "name": "linkedin_url",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "LinkedIn profile URL"
            }
          ]
        },
        {
          "path": "/v1/url-to-markdown",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Convert a web page to clean Markdown",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page URL"
            }
          ]
        },
        {
          "path": "/v1/seo-xray",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "On-page SEO audit of a URL",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page URL"
            }
          ]
        },
        {
          "path": "/v1/email-mx-forensics",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "MX / provider forensics for an email address",
          "params": [
            {
              "name": "email",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Email address"
            }
          ]
        },
        {
          "path": "/v1/social-card-extractor",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract OpenGraph / Twitter card metadata",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page URL"
            }
          ]
        },
        {
          "path": "/v1/sitemap-crawler",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Parse a sitemap into a URL list",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Sitemap or site URL"
            },
            {
              "name": "limit",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Max URLs (default 100)"
            }
          ]
        },
        {
          "path": "/v1/html-table-parser",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Parse HTML tables into JSON",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Page URL"
            },
            {
              "name": "html",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Raw HTML (alternative to url)"
            }
          ]
        },
        {
          "path": "/v1/rss-json-normalizer",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Normalize RSS/Atom feeds to JSON",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Feed URL"
            },
            {
              "name": "limit",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Max items (default 50)"
            }
          ]
        },
        {
          "path": "/v1/prompt-firewall-structurer",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Scan a prompt for injection/PII and return a structured form",
          "params": [
            {
              "name": "prompt",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Prompt text"
            },
            {
              "name": "context",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Additional context"
            },
            {
              "name": "strict",
              "in": "body",
              "required": false,
              "type": "boolean",
              "description": "Strict mode"
            }
          ]
        }
      ]
    },
    {
      "id": "social",
      "wave": 1,
      "name": "Social Analytics",
      "tagline": "Viral video audits, creator profiles, TikTok and YouTube metadata, hook scoring and engagement math.",
      "host": "social.caelaralabs.com",
      "title": "Caelara Labs Social Suite",
      "endpoints": [
        {
          "path": "/v1/video-viral-audit-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Viral audit of a TikTok/YouTube video: metadata + hook score + hashtags + thumbnail",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "TikTok or YouTube video URL"
            }
          ]
        },
        {
          "path": "/v1/creator-profile-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Creator profile audit: bio-link page audit + engagement benchmark",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Link-in-bio or profile page URL"
            },
            {
              "name": "followers",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Follower count"
            },
            {
              "name": "avg_likes",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Average likes per post"
            },
            {
              "name": "avg_comments",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Average comments per post"
            },
            {
              "name": "avg_views",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Average views per post"
            }
          ]
        },
        {
          "path": "/v1/tiktok-oembed",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "TikTok video metadata via public oEmbed",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "TikTok video URL"
            }
          ]
        },
        {
          "path": "/v1/youtube-metadata",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "YouTube video metadata via public oEmbed + thumbnail URLs",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "YouTube video URL or id"
            }
          ]
        },
        {
          "path": "/v1/reels-hook-scorer",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Score the opening hook of a Reel/Short/TikTok script or caption",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Script or caption (first lines matter most)"
            }
          ]
        },
        {
          "path": "/v1/thumbnail-analyzer",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Analyze a thumbnail image: format, dimensions, aspect ratio, size",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Image URL"
            }
          ]
        },
        {
          "path": "/v1/caption-hashtag-extractor",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract hashtags, mentions, links and emoji from a caption",
          "params": [
            {
              "name": "caption",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Post caption"
            }
          ]
        },
        {
          "path": "/v1/bio-link-auditor",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Audit a link-in-bio page: link count, platforms, CTA and tracking",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Bio link page URL"
            }
          ]
        },
        {
          "path": "/v1/transcript-cleaner",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Clean a raw transcript/VTT/SRT: timestamps, fillers, duplicates",
          "params": [
            {
              "name": "transcript",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Raw transcript text"
            }
          ]
        },
        {
          "path": "/v1/engagement-rate-calc",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Compute engagement rate metrics and benchmark tier",
          "params": [
            {
              "name": "followers",
              "in": "query",
              "required": true,
              "type": "integer",
              "description": "Follower count"
            },
            {
              "name": "likes",
              "in": "query",
              "required": true,
              "type": "integer",
              "description": "Likes"
            },
            {
              "name": "comments",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Comments"
            },
            {
              "name": "shares",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Shares"
            },
            {
              "name": "saves",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Saves"
            },
            {
              "name": "views",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Views"
            }
          ]
        }
      ]
    },
    {
      "id": "agent",
      "wave": 1,
      "name": "Agent Safety",
      "tagline": "Input firewall, output validator, PII redaction, prompt-injection scanning, JSON repair and schema enforcement.",
      "host": "agent.caelaralabs.com",
      "title": "Caelara Labs Agent Safety Suite",
      "endpoints": [
        {
          "path": "/v1/agent-input-firewall",
          "method": "POST",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Scan untrusted input: injection risk + PII redaction + sanitized text + allow/review/block verdict",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Untrusted input text"
            },
            {
              "name": "redact_pii",
              "in": "body",
              "required": false,
              "type": "boolean",
              "description": "Redact PII in sanitized output (default true)"
            }
          ]
        },
        {
          "path": "/v1/agent-output-validator",
          "method": "POST",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Validate LLM output: repair JSON, enforce schema, check grounding against a source, extract citations",
          "params": [
            {
              "name": "output",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Raw LLM output"
            },
            {
              "name": "schema",
              "in": "body",
              "required": false,
              "type": "object",
              "description": "JSON Schema subset to enforce"
            },
            {
              "name": "source",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Source text for grounding check"
            }
          ]
        },
        {
          "path": "/v1/pii-redactor",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Redact emails, phones, SSNs, cards (Luhn), IPs, API keys and JWTs",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Text to redact"
            }
          ]
        },
        {
          "path": "/v1/prompt-injection-scanner",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Score text for prompt-injection patterns",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Text to scan"
            }
          ]
        },
        {
          "path": "/v1/token-compressor",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Compress text to a target ratio of its original length",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Text to compress"
            },
            {
              "name": "ratio",
              "in": "body",
              "required": false,
              "type": "number",
              "description": "Target ratio 0.1-0.9 (default 0.5)"
            }
          ]
        },
        {
          "path": "/v1/json-auto-repair",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Repair malformed JSON from LLM output",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Malformed JSON text"
            }
          ]
        },
        {
          "path": "/v1/schema-enforcer",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Validate and coerce data to a JSON Schema",
          "params": [
            {
              "name": "data",
              "in": "body",
              "required": true,
              "type": "object",
              "description": "Data to enforce"
            },
            {
              "name": "schema",
              "in": "body",
              "required": true,
              "type": "object",
              "description": "JSON Schema subset"
            }
          ]
        },
        {
          "path": "/v1/hallucination-diff",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Flag answer sentences unsupported by the source text",
          "params": [
            {
              "name": "source",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Source / ground-truth text"
            },
            {
              "name": "answer",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Model answer to check"
            }
          ]
        },
        {
          "path": "/v1/citation-extractor",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract URLs, DOIs, arXiv ids and author-year citations",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Text containing citations"
            }
          ]
        },
        {
          "path": "/v1/context-chunker",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Split text into token-bounded overlapping chunks",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Text to chunk"
            },
            {
              "name": "max_tokens",
              "in": "body",
              "required": false,
              "type": "integer",
              "description": "Max tokens per chunk (default 500)"
            },
            {
              "name": "overlap",
              "in": "body",
              "required": false,
              "type": "integer",
              "description": "Overlap tokens (default 50)"
            }
          ]
        }
      ]
    },
    {
      "id": "compliance",
      "wave": 2,
      "name": "Compliance & Trust",
      "tagline": "Domain trust, entity KYB, SPF/DMARC grading, IBAN/VAT validation, sanctions screening and security-header audits.",
      "host": "compliance.caelaralabs.com",
      "title": "Caelara Labs Compliance Suite",
      "endpoints": [
        {
          "path": "/v1/domain-trust-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Domain trust report: SPF/DMARC grade + security headers + certificate history + overall trust score",
          "params": [
            {
              "name": "domain",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Domain name, e.g. example.com"
            }
          ]
        },
        {
          "path": "/v1/entity-kyb-composite",
          "method": "POST",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Entity KYB screen: sanctions fuzzy match + VAT/EIN + IBAN/BIC + email disposable check with risk verdict",
          "params": [
            {
              "name": "name",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Legal entity name"
            },
            {
              "name": "vat",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "VAT number incl. country prefix, or US EIN"
            },
            {
              "name": "iban",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "IBAN"
            },
            {
              "name": "bic",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "BIC/SWIFT code"
            },
            {
              "name": "email",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Contact email"
            },
            {
              "name": "watchlist",
              "in": "body",
              "required": false,
              "type": "array",
              "description": "Optional extra names to screen against"
            }
          ]
        },
        {
          "path": "/v1/spf-dmarc-grader",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Grade SPF and DMARC DNS records (A-F)",
          "params": [
            {
              "name": "domain",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Domain name"
            }
          ]
        },
        {
          "path": "/v1/ssl-cert-inspector",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Inspect certificate issuance history via Certificate Transparency",
          "params": [
            {
              "name": "domain",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Domain name"
            }
          ]
        },
        {
          "path": "/v1/ip-asn-reputation",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "ASN lookup and reserved/private range classification for an IP",
          "params": [
            {
              "name": "ip",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "IPv4 or IPv6 address"
            }
          ]
        },
        {
          "path": "/v1/disposable-email-db",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Detect disposable / throwaway email domains and role accounts",
          "params": [
            {
              "name": "email",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Email address or domain"
            }
          ]
        },
        {
          "path": "/v1/iban-bic-validator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Validate IBAN (mod-97, country length) and BIC/SWIFT format",
          "params": [
            {
              "name": "iban",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "IBAN"
            },
            {
              "name": "bic",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "BIC/SWIFT code"
            }
          ]
        },
        {
          "path": "/v1/vat-ein-checkdigit",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Validate EU VAT number check digits and US EIN format",
          "params": [
            {
              "name": "number",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "VAT number with country prefix, or US EIN (NN-NNNNNNN)"
            }
          ]
        },
        {
          "path": "/v1/sanctions-fuzzy-screen",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Fuzzy-match a name against a built-in seed list plus a caller-supplied watchlist",
          "params": [
            {
              "name": "name",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Name to screen"
            },
            {
              "name": "watchlist",
              "in": "body",
              "required": false,
              "type": "array",
              "description": "Extra names to screen against"
            },
            {
              "name": "threshold",
              "in": "body",
              "required": false,
              "type": "number",
              "description": "Match threshold 0.5-1 (default 0.85)"
            }
          ]
        },
        {
          "path": "/v1/security-headers-audit",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Fetch a URL and grade its HTTP security headers",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "URL or hostname to audit"
            }
          ]
        }
      ]
    },
    {
      "id": "ecom",
      "wave": 2,
      "name": "E-Commerce Intelligence",
      "tagline": "Product and storefront X-ray, JSON-LD parsing, GTIN validation, price-drop tracking and margin math.",
      "host": "ecom.caelaralabs.com",
      "title": "Caelara Labs E-Commerce Suite",
      "endpoints": [
        {
          "path": "/v1/product-intel-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Product page intelligence: JSON-LD product, GTIN validation, SKU normalization, review sentiment, ad pixels and price signals",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Product page URL"
            }
          ]
        },
        {
          "path": "/v1/storefront-xray-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Storefront X-ray: platform, ad/analytics stack, payment options, structured data and Shopify catalog sample",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Storefront URL"
            }
          ]
        },
        {
          "path": "/v1/jsonld-product-parser",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract schema.org Product data (offers, ratings, reviews) from a page",
          "params": [
            {
              "name": "url",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Page URL (or supply html)"
            },
            {
              "name": "html",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Raw HTML (or supply url)"
            }
          ]
        },
        {
          "path": "/v1/shopify-feed-extractor",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract the public Shopify products.json catalog with pricing and stock summary",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Shopify store URL"
            },
            {
              "name": "limit",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Products per page 1-250 (default 30)"
            },
            {
              "name": "page",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Page number (default 1)"
            }
          ]
        },
        {
          "path": "/v1/gtin-upc-validator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Validate GTIN-8/12/13/14 (UPC/EAN) check digits and convert formats",
          "params": [
            {
              "name": "code",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Barcode digits"
            }
          ]
        },
        {
          "path": "/v1/price-drop-comparator",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Compare a price series (or old/new price) and flag drops, lows and target hits",
          "params": [
            {
              "name": "prices",
              "in": "body",
              "required": false,
              "type": "array",
              "description": "Price history, oldest first (numbers or {price,date})"
            },
            {
              "name": "old_price",
              "in": "body",
              "required": false,
              "type": "number",
              "description": "Previous price"
            },
            {
              "name": "new_price",
              "in": "body",
              "required": false,
              "type": "number",
              "description": "Current price"
            },
            {
              "name": "threshold_pct",
              "in": "body",
              "required": false,
              "type": "number",
              "description": "Drop/increase threshold percent (default 10)"
            },
            {
              "name": "target_price",
              "in": "body",
              "required": false,
              "type": "number",
              "description": "Target buy price"
            }
          ]
        },
        {
          "path": "/v1/ad-pixel-detector",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Detect ad, analytics and marketing pixels (Meta, TikTok, GA4, GTM, Pinterest, etc.) with tag IDs",
          "params": [
            {
              "name": "url",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Page URL (or supply html)"
            },
            {
              "name": "html",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Raw HTML (or supply url)"
            }
          ]
        },
        {
          "path": "/v1/currency-margin-calc",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Margin, markup, breakeven and target price with FX rate, fees, shipping and tax",
          "params": [
            {
              "name": "cost",
              "in": "query",
              "required": true,
              "type": "number",
              "description": "Unit cost"
            },
            {
              "name": "price",
              "in": "query",
              "required": true,
              "type": "number",
              "description": "Selling price"
            },
            {
              "name": "fx_rate",
              "in": "query",
              "required": false,
              "type": "number",
              "description": "FX multiplier cost currency to price currency (default 1)"
            },
            {
              "name": "fee_pct",
              "in": "query",
              "required": false,
              "type": "number",
              "description": "Marketplace/payment fee percent"
            },
            {
              "name": "fixed_fee",
              "in": "query",
              "required": false,
              "type": "number",
              "description": "Fixed fee per order"
            },
            {
              "name": "shipping_cost",
              "in": "query",
              "required": false,
              "type": "number",
              "description": "Shipping cost in price currency"
            },
            {
              "name": "tax_pct",
              "in": "query",
              "required": false,
              "type": "number",
              "description": "Tax percent included in price"
            },
            {
              "name": "target_margin_pct",
              "in": "query",
              "required": false,
              "type": "number",
              "description": "Desired margin percent for suggested price"
            },
            {
              "name": "cost_currency",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Cost currency code"
            },
            {
              "name": "price_currency",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Price currency code"
            }
          ]
        },
        {
          "path": "/v1/review-sentiment-parser",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Score review sentiment with aspect breakdown (quality, price, shipping, fit, service)",
          "params": [
            {
              "name": "reviews",
              "in": "body",
              "required": false,
              "type": "array",
              "description": "Array of review strings or {text, rating}"
            },
            {
              "name": "text",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Newline-separated reviews"
            }
          ]
        },
        {
          "path": "/v1/sku-normalizer",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Normalize SKUs into canonical, compact and match-key forms",
          "params": [
            {
              "name": "skus",
              "in": "body",
              "required": false,
              "type": "array",
              "description": "Array of SKU strings"
            },
            {
              "name": "sku",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Single SKU string"
            }
          ]
        }
      ]
    },
    {
      "id": "seo",
      "wave": 2,
      "name": "SEO & GEO Readiness",
      "tagline": "llms.txt and AI-crawler audits, redirect tracing, schema validation, SERP previews and link scanning.",
      "host": "seo.caelaralabs.com",
      "title": "Caelara Labs SEO & GEO Suite",
      "endpoints": [
        {
          "path": "/v1/geo-readiness-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Generative-engine readiness score: llms.txt + AI crawler access + structured data + content clarity",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page URL to assess"
            }
          ]
        },
        {
          "path": "/v1/technical-seo-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Technical SEO audit: redirects, meta, canonical, headings, hreflang, schema, robots.txt with scored issues",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page URL to audit"
            }
          ]
        },
        {
          "path": "/v1/llms-txt-auditor",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Fetch and audit /llms.txt (and llms-full.txt) against the llms.txt format",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Any URL on the target site"
            }
          ]
        },
        {
          "path": "/v1/ai-bot-robots-check",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Check whether GPTBot, PerplexityBot, Google-Extended and other AI crawlers are allowed by robots.txt",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "URL (path is evaluated against robots.txt)"
            }
          ]
        },
        {
          "path": "/v1/redirect-chain-tracer",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Trace a redirect chain hop by hop with loop detection and status issues",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Starting URL"
            },
            {
              "name": "max_hops",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Max hops 1-10 (default 10)"
            }
          ]
        },
        {
          "path": "/v1/schema-org-validator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract and validate JSON-LD / microdata structured data on a page",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page URL"
            }
          ]
        },
        {
          "path": "/v1/serp-pixel-preview",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Pixel-width SERP snippet preview with truncation for desktop and mobile",
          "params": [
            {
              "name": "title",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page title"
            },
            {
              "name": "description",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Meta description"
            },
            {
              "name": "url",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Display URL"
            }
          ]
        },
        {
          "path": "/v1/keyword-ngrams-extractor",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract top keyword unigrams, bigrams and trigrams with density",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Text to analyze"
            },
            {
              "name": "max_n",
              "in": "body",
              "required": false,
              "type": "integer",
              "description": "Largest n-gram size 1-3 (default 3)"
            },
            {
              "name": "top",
              "in": "body",
              "required": false,
              "type": "integer",
              "description": "Results per n-gram size (default 15)"
            },
            {
              "name": "include_stopwords",
              "in": "body",
              "required": false,
              "type": "boolean",
              "description": "Keep stopword-edged phrases"
            }
          ]
        },
        {
          "path": "/v1/hreflang-validator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Validate hreflang annotations: codes, x-default, self-reference and optional return links",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page URL"
            },
            {
              "name": "check_return_links",
              "in": "query",
              "required": false,
              "type": "boolean",
              "description": "Verify reciprocal links on up to 5 alternates (true/false)"
            }
          ]
        },
        {
          "path": "/v1/broken-link-scanner",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Check outbound and internal links on a page for 4xx/5xx and dead hosts",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Page URL"
            },
            {
              "name": "max_links",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Max links to check 1-40 (default 25)"
            }
          ]
        }
      ]
    },
    {
      "id": "docs",
      "wave": 2,
      "name": "Document Utilities",
      "tagline": "Invoice-to-JSON, universal data bridge, CSV/XML conversion, safe markdown, address and phone normalization.",
      "host": "docs.caelaralabs.com",
      "title": "Caelara Labs Document Utilities Suite",
      "endpoints": [
        {
          "path": "/v1/invoice-json-composite",
          "method": "POST",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Convert raw invoice text into structured JSON: number, dates, currency, line items, totals and consistency checks",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Raw invoice text"
            }
          ]
        },
        {
          "path": "/v1/universal-data-bridge",
          "method": "POST",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Convert data between CSV, XML and JSON with format auto-detection and type inference",
          "params": [
            {
              "name": "data",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Input document (string) or JSON value"
            },
            {
              "name": "from",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Source format: auto|csv|xml|json (default auto)"
            },
            {
              "name": "to",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Target format: json|csv|xml"
            }
          ]
        },
        {
          "path": "/v1/csv-to-typed-json",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Parse CSV into JSON rows with inferred number, boolean, null and date types",
          "params": [
            {
              "name": "csv",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "CSV text"
            },
            {
              "name": "delimiter",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Delimiter (auto-detected if omitted)"
            },
            {
              "name": "header",
              "in": "body",
              "required": false,
              "type": "boolean",
              "description": "First row is header (default true)"
            }
          ]
        },
        {
          "path": "/v1/xml-to-json-clean",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Convert XML to clean JSON (attributes prefixed with @, repeated tags to arrays)",
          "params": [
            {
              "name": "xml",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "XML text"
            }
          ]
        },
        {
          "path": "/v1/markdown-to-sanitized-html",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Render markdown to HTML with all raw HTML escaped and unsafe URLs removed",
          "params": [
            {
              "name": "markdown",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Markdown text"
            }
          ]
        },
        {
          "path": "/v1/html-to-clean-text",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Strip HTML to readable plain text, dropping scripts, styles and tags",
          "params": [
            {
              "name": "html",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "HTML text"
            },
            {
              "name": "keep_links",
              "in": "body",
              "required": false,
              "type": "boolean",
              "description": "Append link URLs in brackets"
            }
          ]
        },
        {
          "path": "/v1/regex-entity-extractor",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract emails, URLs, phones, IPs, dates, money, hashtags, mentions and more from text",
          "params": [
            {
              "name": "text",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Text to scan"
            },
            {
              "name": "types",
              "in": "body",
              "required": false,
              "type": "array",
              "description": "Entity types to extract (array of strings)"
            }
          ]
        },
        {
          "path": "/v1/address-normalizer",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Normalize a postal address: casing, street/directional abbreviations, unit, ZIP and state",
          "params": [
            {
              "name": "address",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Free-form address"
            }
          ]
        },
        {
          "path": "/v1/phone-e164-formatter",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Format a phone number to E.164 with country detection and validity check",
          "params": [
            {
              "name": "phone",
              "in": "body",
              "required": true,
              "type": "string",
              "description": "Phone number"
            },
            {
              "name": "country",
              "in": "body",
              "required": false,
              "type": "string",
              "description": "Default ISO-2 country code, e.g. US"
            }
          ]
        },
        {
          "path": "/v1/dedupe-fuzzy-matcher",
          "method": "POST",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Cluster near-duplicate strings using Jaro-Winkler and token similarity",
          "params": [
            {
              "name": "items",
              "in": "body",
              "required": true,
              "type": "array",
              "description": "Array of strings"
            },
            {
              "name": "threshold",
              "in": "body",
              "required": false,
              "type": "number",
              "description": "Similarity threshold 0.5-1 (default 0.88)"
            }
          ]
        }
      ]
    },
    {
      "id": "crypto",
      "wave": 3,
      "name": "On-Chain Intelligence",
      "tagline": "Token safety scoring, wallet portfolios, Solana mint audits, ERC-20 inspection, DEX depth and gas estimates.",
      "host": "crypto.caelaralabs.com",
      "title": "Caelara Labs On-Chain Intelligence Suite",
      "endpoints": [
        {
          "path": "/v1/token-safety-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Safety score for an EVM or Solana token: contract/mint authority checks, holder concentration, DEX liquidity depth, pool age and trade-flow flags",
          "params": [
            {
              "name": "address",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Token contract (0x...) or Solana mint address"
            },
            {
              "name": "chain",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Chain: base|ethereum|arbitrum|optimism (default base)"
            }
          ]
        },
        {
          "path": "/v1/wallet-portfolio-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "USD portfolio for an EVM or Solana wallet: native balance, major token balances, prices and allocation",
          "params": [
            {
              "name": "address",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Wallet address (0x... or Solana)"
            },
            {
              "name": "chain",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Chain: base|ethereum|arbitrum|optimism (EVM, default base). Solana is auto-detected from the address format"
            }
          ]
        },
        {
          "path": "/v1/solana-mint-auditor",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Audit a Solana SPL mint: mint/freeze authority, supply, decimals, Token-2022 extensions and top-holder concentration",
          "params": [
            {
              "name": "mint",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Solana mint address"
            }
          ]
        },
        {
          "path": "/v1/base-erc20-inspector",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Inspect an ERC-20 on Base or another EVM chain: name, symbol, decimals, supply, owner, proxy slot and risky function selectors",
          "params": [
            {
              "name": "address",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Token contract address"
            },
            {
              "name": "chain",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Chain: base|ethereum|arbitrum|optimism (default base)"
            }
          ]
        },
        {
          "path": "/v1/dex-liquidity-depth",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "DEX pools for a token with liquidity, volume, and estimated price impact for $100 to $100k trades",
          "params": [
            {
              "name": "token",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Token address (EVM or Solana mint)"
            },
            {
              "name": "chain",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "DexScreener chain id filter, e.g. base, solana, ethereum"
            }
          ]
        },
        {
          "path": "/v1/stablecoin-depeg-monitor",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Peg deviation in basis points for major stablecoins from independent exchange feeds",
          "params": [
            {
              "name": "symbols",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Comma list from USDT,USDC,DAI (default all)"
            }
          ]
        },
        {
          "path": "/v1/gas-fee-estimator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Live gas price and USD cost estimates for transfers, ERC-20 transfers and swaps on EVM chains",
          "params": [
            {
              "name": "chain",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Chain: base|ethereum|arbitrum|optimism (default base)"
            }
          ]
        },
        {
          "path": "/v1/tx-hash-decoder",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Decode an EVM transaction: status, fee, method selector, ERC-20 transfers and approvals",
          "params": [
            {
              "name": "hash",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Transaction hash (0x + 64 hex)"
            },
            {
              "name": "chain",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Chain: base|ethereum|arbitrum|optimism (default base)"
            }
          ]
        },
        {
          "path": "/v1/address-checksum-validator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Validate an EVM address (EIP-55 checksum) or Solana address (base58, 32 bytes) and return the canonical form",
          "params": [
            {
              "name": "address",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Address to validate"
            }
          ]
        },
        {
          "path": "/v1/token-price-aggregator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Median USD price for a ticker across Coinbase, Kraken and Bitstamp with spread, plus DEX price when a contract address is supplied",
          "params": [
            {
              "name": "symbol",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Ticker, e.g. ETH, BTC, SOL"
            },
            {
              "name": "address",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Optional token contract/mint for DEX pricing"
            }
          ]
        }
      ]
    },
    {
      "id": "geo",
      "wave": 3,
      "name": "Global Locale",
      "tagline": "Timezone and scheduling math, public holidays, live FX, VAT/GST rates, postal validation and cross-border checkout.",
      "host": "geo.caelaralabs.com",
      "title": "Caelara Labs Global Locale Suite",
      "endpoints": [
        {
          "path": "/v1/global-scheduling-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Find meeting slots that fall inside working hours for every participant timezone, skipping weekends and public holidays, with per-participant local times",
          "params": [
            {
              "name": "timezones",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Comma list of IANA timezones; the first is the organizer whose local day anchors the search"
            },
            {
              "name": "date",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Organizer-local date YYYY-MM-DD (default today)"
            },
            {
              "name": "duration_minutes",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Meeting length in minutes (default 60)"
            },
            {
              "name": "work_start",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Working day start HH:MM (default 09:00)"
            },
            {
              "name": "work_end",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Working day end HH:MM (default 17:00)"
            },
            {
              "name": "countries",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Comma list of ISO alpha-2 codes aligned with timezones, used to skip public holidays"
            }
          ]
        },
        {
          "path": "/v1/cross-border-checkout-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Cross-border checkout quote: FX conversion into the destination currency, VAT/GST, postal-code validation and EU reverse-charge eligibility",
          "params": [
            {
              "name": "amount",
              "in": "query",
              "required": true,
              "type": "number",
              "description": "Order subtotal in the source currency"
            },
            {
              "name": "currency",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Source currency ISO 4217 code, e.g. USD"
            },
            {
              "name": "country",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Destination country (ISO alpha-2, e.g. DE)"
            },
            {
              "name": "postal_code",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Destination postal code to validate"
            },
            {
              "name": "prices_include_tax",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "true when the amount already includes tax"
            },
            {
              "name": "vat_id",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Buyer VAT ID for B2B reverse-charge screening (format only, not VIES-verified)"
            },
            {
              "name": "origin_country",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Seller country (ISO alpha-2) for reverse-charge screening"
            }
          ]
        },
        {
          "path": "/v1/timezone-converter",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Convert a date-time between IANA timezones with offsets, abbreviations and DST flags",
          "params": [
            {
              "name": "from",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Source IANA timezone, e.g. America/New_York"
            },
            {
              "name": "to",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Comma list of target IANA timezones"
            },
            {
              "name": "time",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "ISO 8601 time; wall time is read in the source timezone (default now)"
            }
          ]
        },
        {
          "path": "/v1/business-hours-calc",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Is a location open right now (or at a given instant) and when does it next open or close",
          "params": [
            {
              "name": "tz",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "IANA timezone of the business"
            },
            {
              "name": "start",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Opening time HH:MM (default 09:00)"
            },
            {
              "name": "end",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Closing time HH:MM (default 17:00)"
            },
            {
              "name": "days",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Comma list of open weekdays, 0=Sunday..6=Saturday (default 1,2,3,4,5)"
            },
            {
              "name": "at",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "ISO 8601 instant to evaluate (default now)"
            }
          ]
        },
        {
          "path": "/v1/public-holiday-lookup",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Public holidays for a country and year, with an optional is-holiday check for one date",
          "params": [
            {
              "name": "country",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "ISO alpha-2 country code"
            },
            {
              "name": "year",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Year (default current)"
            },
            {
              "name": "date",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Optional YYYY-MM-DD to test"
            }
          ]
        },
        {
          "path": "/v1/live-fx-rates",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Live foreign-exchange rates for a base currency with optional amount conversion",
          "params": [
            {
              "name": "base",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Base currency ISO 4217 (default USD)"
            },
            {
              "name": "symbols",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Comma list of target currencies (default major set)"
            },
            {
              "name": "amount",
              "in": "query",
              "required": false,
              "type": "number",
              "description": "Amount of the base currency to convert"
            }
          ]
        },
        {
          "path": "/v1/vat-gst-rate-lookup",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Standard and reduced VAT/GST rates for a country with optional tax amount calculation",
          "params": [
            {
              "name": "country",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "ISO alpha-2 country code"
            },
            {
              "name": "amount",
              "in": "query",
              "required": false,
              "type": "number",
              "description": "Net amount to compute tax on"
            }
          ]
        },
        {
          "path": "/v1/postal-code-validator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Validate and normalize a postal code for a country",
          "params": [
            {
              "name": "country",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "ISO alpha-2 country code"
            },
            {
              "name": "code",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Postal code to validate"
            }
          ]
        },
        {
          "path": "/v1/country-iso-enricher",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Resolve a country name or ISO code to alpha-2/alpha-3/numeric codes, currency, calling code, region, capital and primary timezone",
          "params": [
            {
              "name": "q",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Country name, alpha-2, alpha-3 or numeric code"
            }
          ]
        },
        {
          "path": "/v1/distance-haversine-calc",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Great-circle distance, initial bearing and midpoint between two coordinates",
          "params": [
            {
              "name": "lat1",
              "in": "query",
              "required": true,
              "type": "number",
              "description": "Latitude of point A"
            },
            {
              "name": "lon1",
              "in": "query",
              "required": true,
              "type": "number",
              "description": "Longitude of point A"
            },
            {
              "name": "lat2",
              "in": "query",
              "required": true,
              "type": "number",
              "description": "Latitude of point B"
            },
            {
              "name": "lon2",
              "in": "query",
              "required": true,
              "type": "number",
              "description": "Longitude of point B"
            }
          ]
        }
      ]
    },
    {
      "id": "media",
      "wave": 3,
      "name": "Dynamic Media",
      "tagline": "Open Graph and social cards, QR codes, color palettes, HD favicons, avatars, badges and image inspection.",
      "host": "media.caelaralabs.com",
      "title": "Caelara Labs Dynamic Media Suite",
      "endpoints": [
        {
          "path": "/v1/brand-kit-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Build a brand kit from a domain: best-resolution icon, extracted palette with accessible text colors, initials avatar and badge assets",
          "params": [
            {
              "name": "domain",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Brand domain, e.g. stripe.com"
            },
            {
              "name": "name",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Brand display name (default derived from the domain)"
            },
            {
              "name": "color",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Brand color override (hex, with or without #)"
            }
          ]
        },
        {
          "path": "/v1/dynamic-social-card-composite",
          "method": "GET",
          "tier": "composite",
          "price_usdc": "0.025",
          "summary": "Generate a full social-card set (Open Graph, Twitter, square, story) as SVG with a QR code, meta tags and alt text",
          "params": [
            {
              "name": "title",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Card headline"
            },
            {
              "name": "subtitle",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Supporting line"
            },
            {
              "name": "brand",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Brand label shown on the card"
            },
            {
              "name": "url",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Destination URL; adds a QR code and domain label"
            },
            {
              "name": "theme",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "dark (default) or light"
            },
            {
              "name": "accent",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Accent color (hex, with or without #)"
            },
            {
              "name": "bg",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Background color (hex, with or without #)"
            },
            {
              "name": "fg",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Text color (hex, with or without #)"
            }
          ]
        },
        {
          "path": "/v1/edge-og-svg-generator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Render an Open Graph card (default 1200x630) as SVG",
          "params": [
            {
              "name": "title",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Headline"
            },
            {
              "name": "subtitle",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Supporting line"
            },
            {
              "name": "brand",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Brand label"
            },
            {
              "name": "theme",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "dark (default) or light"
            },
            {
              "name": "bg",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Background color (hex, with or without #)"
            },
            {
              "name": "fg",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Text color (hex, with or without #)"
            },
            {
              "name": "accent",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Accent color (hex, with or without #)"
            },
            {
              "name": "width",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Width in px (200-4000, default 1200)"
            },
            {
              "name": "height",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Height in px (200-4000, default 630)"
            },
            {
              "name": "format",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "json (default, includes svg + data URI) or svg (raw image/svg+xml)"
            }
          ]
        },
        {
          "path": "/v1/qr-code-svg-builder",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Encode text or a URL as a scannable QR code SVG",
          "params": [
            {
              "name": "text",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Text or URL to encode (max 1000 bytes)"
            },
            {
              "name": "ecc",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Error correction: L, M (default), Q or H"
            },
            {
              "name": "size",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Rendered size in px (64-2048, default 256)"
            },
            {
              "name": "margin",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Quiet zone in modules (0-16, default 4)"
            },
            {
              "name": "fg",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Module color (hex, with or without #)"
            },
            {
              "name": "bg",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Background color (hex, with or without #)"
            },
            {
              "name": "format",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "json (default, includes svg + data URI) or svg (raw image/svg+xml)"
            }
          ]
        },
        {
          "path": "/v1/color-palette-extractor",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Extract a dominant-color palette from a PNG or SVG image, or normalize a list of colors, with contrast ratios",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Image URL (PNG or SVG are pixel/markup sampled)"
            },
            {
              "name": "colors",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Comma list of hex colors to analyze instead of an image"
            },
            {
              "name": "count",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Number of colors (1-12, default 5)"
            }
          ]
        },
        {
          "path": "/v1/favicon-hd-resolver",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Find the highest-resolution icon a domain publishes (SVG, apple-touch, Android, favicon) with dimensions",
          "params": [
            {
              "name": "domain",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Domain or URL, e.g. github.com"
            }
          ]
        },
        {
          "path": "/v1/avatar-initials-svg",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Generate a deterministic initials avatar SVG with an accessible text color",
          "params": [
            {
              "name": "name",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Person or company name"
            },
            {
              "name": "size",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Size in px (24-1024, default 128)"
            },
            {
              "name": "shape",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "circle (default), rounded or square"
            },
            {
              "name": "bg",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Background color (default derived from the name) (hex, with or without #)"
            },
            {
              "name": "fg",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Text color (default chosen for contrast) (hex, with or without #)"
            },
            {
              "name": "format",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "json (default, includes svg + data URI) or svg (raw image/svg+xml)"
            }
          ]
        },
        {
          "path": "/v1/badge-shield-generator",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Generate a status badge SVG (label | message) in flat or flat-square style",
          "params": [
            {
              "name": "label",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Left label"
            },
            {
              "name": "message",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Right message"
            },
            {
              "name": "color",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Message background color (default 2ea44f) (hex, with or without #)"
            },
            {
              "name": "label_color",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "Label background color (default 555555) (hex, with or without #)"
            },
            {
              "name": "style",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "flat (default) or flat-square"
            },
            {
              "name": "format",
              "in": "query",
              "required": false,
              "type": "string",
              "description": "json (default, includes svg + data URI) or svg (raw image/svg+xml)"
            }
          ]
        },
        {
          "path": "/v1/aspect-ratio-calc",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Reduce dimensions to an aspect ratio, name the closest standard ratio, scale to a target and map to social-media presets",
          "params": [
            {
              "name": "width",
              "in": "query",
              "required": true,
              "type": "integer",
              "description": "Width"
            },
            {
              "name": "height",
              "in": "query",
              "required": true,
              "type": "integer",
              "description": "Height"
            },
            {
              "name": "target_width",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Scale to this width"
            },
            {
              "name": "target_height",
              "in": "query",
              "required": false,
              "type": "integer",
              "description": "Scale to this height"
            }
          ]
        },
        {
          "path": "/v1/image-meta-inspector",
          "method": "GET",
          "tier": "atomic",
          "price_usdc": "0.005",
          "summary": "Inspect a remote image: format, dimensions, animation, alpha, size and content type from the file header",
          "params": [
            {
              "name": "url",
              "in": "query",
              "required": true,
              "type": "string",
              "description": "Image URL"
            }
          ]
        }
      ]
    }
  ]
}
