x402

# pip install "x402[evm]" requests
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients.requests import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import ExactEvmScheme

account = Account.from_key(os.environ["WALLET_PRIVATE_KEY"])

client = x402ClientSync()
client.register("eip155:8453", ExactEvmScheme(EthAccountSigner(account)))
session = x402_requests(client)

response = session.get(
    "https://api.financialdatasets.ai/earnings?ticker=NVDA&limit=4"
)
print(response.status_code)                    # 200
print(response.headers["PAYMENT-RESPONSE"])    # base64 receipt with the transaction hash
print(response.json()["earnings"][0])

// npm install @x402/fetch @x402/evm viem
import { privateKeyToAccount } from "viem/accounts";
import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";

const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);

const client = new x402Client();
client.register("eip155:8453", new ExactEvmScheme(account));
const fetchWithPayment = wrapFetchWithPayment(fetch, client);

const response = await fetchWithPayment(
  "https://api.financialdatasets.ai/earnings?ticker=NVDA&limit=4"
);
console.log(response.status);                          // 200
console.log(response.headers.get("PAYMENT-RESPONSE")); // base64 receipt with the transaction hash
console.log((await response.json()).earnings[0]);

# Without a client library, the request returns the 402 and the payment terms.
curl -i "https://api.financialdatasets.ai/earnings?ticker=NVDA&limit=4"

# HTTP/2 402
# payment-required: eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIi...
# {"error": "Payment required", "message": "Send an X-API-KEY header, or pay per call with x402 ..."}