Pay Per Call

pip install "x402[evm,httpx]"

import asyncio
import os

import httpx
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402_httpx_transport
from x402.mechanisms.evm.exact import ExactEvmScheme

API_URL = "https://api.limitguard.ai"
RISK_PATH = "/v1/risk/score"  # priced per call, fresh tier: see /pricing


async def check_risk(entity_name: str, country: str) -> dict:
    """POST /v1/risk/score, paying the 402 automatically with USDC on Base."""
    account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])  # 0x-prefixed hex key

    # "eip155:*" matches Base (eip155:8453) and any other EVM chain Limitguard quotes.
    client = x402Client().register("eip155:*", ExactEvmScheme(account))
    # Refuse to auto-pay more than $1 for any single call. Raise this for a
    # pricier endpoint (e.g. /v1/kyb/check at $1.50) before calling it.
    client.set_spend_controls({"max_amount_per_payment": "$1.00"})

    async with httpx.AsyncClient(
        transport=x402_httpx_transport(client), base_url=API_URL, timeout=30,
    ) as http:
        response = await http.post(
            RISK_PATH, json={"entity_name": entity_name, "country": country}
        )
    response.raise_for_status()
    return response.json()


if __name__ == "__main__":
    result = asyncio.run(check_risk("Acme Corp BV", "NL"))
    print(f"Risk score: {result['risk_score']} - {result['recommendation']}")

pip install "limitguard[solana]>=0.1.4"

import asyncio
import os

from limitguard import LimitGuardClient
from limitguard.x402 import SolanaWallet
from solders.keypair import Keypair


async def check_risk(entity_name: str, country: str) -> dict:
    """POST /v1/risk/score, paying the 402 with USDC on Solana."""
    keypair = Keypair.from_base58_string(os.environ["SOLANA_PRIVATE_KEY"])
    # Co-sign mode (the default): Limitguard's fee payer pays the network fee,
    # so this wallet needs USDC only, no SOL.
    wallet = SolanaWallet(keypair=keypair)

    async with LimitGuardClient(wallet=wallet) as client:
        result = await client.risk_score(entity_name, country)
    return result.model_dump()


if __name__ == "__main__":
    result = asyncio.run(check_risk("Acme Corp BV", "NL"))
    print(f"Risk score: {result['risk_score']} - {result['recommendation']}")