ES
Identificadores de empresas y comercio · x402

sanctions-check

Cribado de sanciones de un nombre de persona, empresa o buque frente a la lista consolidada de cribado de EE. UU. (SDN de OFAC con alias y otras listas del Tesoro, Commerce BIS y Estado), la lista consolidada de sanciones financieras de la UE (FSF), el registro nacional francés de congelación de activos (DG Trésor) y la lista de sanciones del Reino Unido (FCDO). Coincidencia difusa de tokens Jaro-Winkler con puntuación, programas y fecha de nacimiento; listas actualizadas a diario.

0.005 USDC / llamada · {atomic} atómico · 5000 atomic

Endpoint

GET|POST https://forge-tools.dentreprise.workers.dev/api/sanctions-check

Parámetros

NombreObligatorioTipoDescripción
nameObligatoriostringName to screen
typeOpcionalstringperson, entity or vessel (optional)
listsOpcionalstringofac,eu,fr,uk (default all)
thresholdOpcionalstring0.7-1, default 0.88
maxOpcionalstring1-50

Ejemplo de petición (sin pagar — se espera 402)

curl -sS -D - "https://forge-tools.dentreprise.workers.dev/api/sanctions-check?name=Bank+Rossiya&type=entity"

Ejemplo de desafío 402

El mismo objeto se envía también como cabecera PAYMENT-REQUIRED en base64. Las cantidades son unidades atómicas de USDC (6 decimales).

{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://forge-tools.dentreprise.workers.dev/api/sanctions-check",
    "description": "Sanctions screening of a person, company or vessel name against the US Consolidated Screening List (OFAC SDN with aliases plus other Treasury, Commerce BIS and State lists), the EU consolidated financial sanctions list (FSF), the French national asset-freeze register (DG Trésor) and the UK sanctions list (FCDO). Fuzzy Jaro-Winkler token matching with score, programmes, DOB; lists refreshed daily.",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "5000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x7B8bf45ac6AcbA6D4CFB626b57D3f5fF3C9C89F7",
      "maxTimeoutSeconds": 120,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

Reintentar con pago

curl -sS "https://forge-tools.dentreprise.workers.dev/api/sanctions-check?name=Bank+Rossiya&type=entity" \
  -H "PAYMENT-SIGNATURE: $PAYMENT"

Ejemplo de respuesta

{
  "query": "Bank Rossiya",
  "match": true,
  "highest_score": 1,
  "hits": [
    {
      "list": "eu",
      "name": "Bank Rossiya",
      "score": 1,
      "programmes": "UKR"
    }
  ]
}

Demo / muestra gratuita

Esta herramienta está en el worker de la oleada 1. ?demo=1 devuelve una muestra o un extracto etiquetado con HTTP 200 y sin pago. El cuerpo no son datos en vivo. Las 3 primeras llamadas reales con éxito por IP y día UTC también son gratuitas.

curl -sS "https://forge-tools.dentreprise.workers.dev/api/sanctions-check?name=Bank+Rossiya&type=entity&demo=1"

Respuesta de demo etiquetada

{
  "demo": true,
  "demo_label": "DEMO / SAMPLE — not live data. This is a labelled example response and was not charged.",
  "charged": false,
  "tool": "/api/sanctions-check",
  "docs": "https://agent-hub.dentreprise.workers.dev/tools/sanctions-check/",
  "how_to_get_live_data": "Call the same URL without demo=1. The first 3 successful real calls per IP per UTC day are free; after that attach an x402 v2 PAYMENT-SIGNATURE (USDC on Base).",
  "sample": {
    "query": "Bank Rossiya",
    "match": true,
    "highest_score": 1,
    "hits": [
      {
        "list": "eu",
        "name": "Bank Rossiya",
        "score": 1,
        "programmes": "UKR"
      }
    ]
  }
}

JavaScript — @x402/fetch

Cliente oficial x402 v2. Instale @x402/fetch y @x402/evm. El nombre de paquete antiguo x402-fetch es la línea v1 obsoleta y no debe usarse con estos endpoints.

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

// Official x402 v2 client. The older package name "x402-fetch" is the deprecated v1 line.
const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await fetchWithPayment(
  "https://forge-tools.dentreprise.workers.dev/api/sanctions-check?name=Bank+Rossiya&type=entity"
);
console.log(await res.json());

Python — x402

Paquete oficial de PyPI x402. Use x402HttpxClient (async) o x402_requests (sync) tras register_exact_evm_client con EthAccountSigner.

import asyncio
import os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Official PyPI package: x402
account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])
client = x402Client()
register_exact_evm_client(client, EthAccountSigner(account))

async def main():
    async with x402HttpxClient(client) as http:
        res = await http.get("https://forge-tools.dentreprise.workers.dev/api/sanctions-check?name=Bank+Rossiya&type=entity")
        print(res.json())

asyncio.run(main())

# Sync alternative:
# from x402 import x402ClientSync
# from x402.http.clients import x402_requests
# client = x402ClientSync()
# register_exact_evm_client(client, EthAccountSigner(account))
# with x402_requests(client) as session:
#     print(session.get("https://forge-tools.dentreprise.workers.dev/api/sanctions-check?name=Bank+Rossiya&type=entity").json())

Servidor MCP — forge-agent-mcp

stdio cubre el catálogo completo (ambos hosts de API). Clone forge-agent-mcp y apunte su cliente MCP a src/server.mjs. El remoto Streamable HTTP alojado en la pasarela original sigue exponiendo solo las herramientas de esa pasarela.

{
  "mcpServers": {
    "forge-agent-hub": {
      "command": "node",
      "args": ["/path/to/forge-agent-mcp/src/server.mjs"]
    },
    "forge-agent-api": {
      "url": "https://x402-gateway.forge-x402.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Contenedor de herramienta LangChain

Envuelva los mismos clientes x402 como herramienta LangChain con DynamicStructuredTool (@langchain/core) o @tool (langchain_core).

import { DynamicStructuredTool } from "@langchain/core/tools";
import { z } from "zod";
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

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

export const sanctions_check = new DynamicStructuredTool({
  name: "sanctions_check",
  description: "Sanctions screening of a person, company or vessel name against the US Consolidated Screening List (OFAC SDN with aliases plus other Treasury, Commerce BIS and State lists), the EU consolidated financial sanctions list (FSF), the French national asset-freeze register (DG Trésor) and the UK sanctions list (FCDO).",
  schema: z.object({}),
  func: async (input) => {
    const res = await fetchWithPayment("https://forge-tools.dentreprise.workers.dev/api/sanctions-check" + "?" + new URLSearchParams(input));
    return JSON.stringify(await res.json());
  },
});
import os
from langchain_core.tools import tool
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])
client = x402ClientSync()
register_exact_evm_client(client, EthAccountSigner(account))

@tool
def sanctions_check() -> str:
    """Sanctions screening of a person, company or vessel name against the US Consolidated Screening List (OFAC SDN with aliases plus other Treasury, Commerce BIS and State lists), the EU consolidated financial sanctions list (FSF), the French national asset-freeze register (DG Trésor) and the UK sanctions list (FCDO)."""
    with x402_requests(client) as session:
        return session.get("https://forge-tools.dentreprise.workers.dev/api/sanctions-check").text

Endpoints relacionados

Identificadores de empresas y comercio · x402

lei-lookup

Consulta de Identificador de Entidad Legal en el registro oficial GLEIF: por LEI (con comprobación de suma ISO 17442) o por búsqueda de denominación con país opcional.

0.003 USDC/ llamada
Documentación →
Identificadores de empresas y comercio · x402

eori-validate

Validación de números EORI (identificador aduanero) frente al registro oficial EOS de la Comisión Europea, y de números GB del Reino Unido frente a HMRC.

0.003 USDC/ llamada
Documentación →
Identificadores de empresas y comercio · x402

siren-check

Validación de dígitos de control SIREN (9) / SIRET (14) franceses (Luhn, excepción La Poste), formato, NIC y el número de IVA intra-UE derivado.

0.001 USDC/ llamada
Documentación →
Identificadores de empresas y comercio · x402

fr-legal-status

Estado jurídico de una empresa francesa por SIREN/SIRET: estado administrativo Sirene (activa/cesada, fecha de cierre, forma jurídica, NAF, sede) más procedimientos colectivos BODACC (sauvegarde, redressement, liquidation judiciaire, clôture) con la última etapa, un indicador en curso y el nivel de riesgo.

0.003 USDC/ llamada
Documentación →