Fly · Entity Evidence

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://mercator-entity-evidence.fly.dev/v1/entity-evidence", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "domain": "stripe.com",
    "fields": [
      "legal_name",
      "headquarters",
      "industry",
      "key_executives"
    ],
    "max_age_days": 30
  }),
});
const data = await res.json();

curl -X POST \
  "https://mercator-entity-evidence.fly.dev/v1/entity-evidence" \
  -H "Content-Type: application/json" \
  -d '{"domain":"stripe.com","fields":["legal_name","headquarters","industry","key_executives"],"max_age_days":30}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "billable": true,
  "billing_note": "",
  "conflicts": [],
  "entity": {
    "aliases": [
      "Stripe"
    ],
    "canonical_domain": "stripe.com",
    "canonical_name": "Stripe, Inc.",
    "confidence": 0.9,
    "resolved_from": "stripe.com"
  },
  "fields": {
    "headquarters": {
      "agreement": "2_of_3",
      "confidence": 0.85,
      "oldest_retrieved_at": "2026-08-28T12:00:00Z",
      "sources": [
        {
          "excerpt": "Stripe is headquartered in South San Francisco, California",
          "primary": true,
          "retrieved_at": "2026-08-28T12:00:00Z",
          "source_id": "company_about",
          "url": "https://stripe.com/about"
        }
      ],
      "value": "South San Francisco, California",
      "variants": [
        "South San Francisco",
        "South San Francisco, California"
      ]
    }
  },
  "informative_fields": [
    "headquarters"
  ],
  "reachability": {
    "independent_origins": 2,
    "note": "2 independent sources answered, so agreement above one origin was reachable for this company.",
    "origin_classes": [
      "self_published",
      "third_party"
    ],
    "own_site_answered": true,
    "registries": [],
    "registries_absent": [
      "gleif_lei",
      "sec_submissions",
      "sec_proxy"
    ],
    "single_origin": false,
    "single_origin_field_reason": "",
    "single_origin_fields": []
  },
  "response_hash": "…",
  "sources_consulted": [
    "company_about",
    "company_site",
    "wikipedia"
  ],
  "status": "PARTIAL",
  "unresolved": [
    {
      "field": "last_reported_funding",
      "reason": "no source stated this field"
    }
  ]
}