Taxonomy Itis

{
  "author": "(Linnaeus, 1771)",
  "child_taxa": [
    {
      "name": "Puma concolor concolor",
      "rank": "Subspecies",
      "tsn": "552780"
    },
    {
      "name": "Puma concolor couguar",
      "rank": "Subspecies",
      "tsn": "622093"
    }
  ],
  "common_names": [
    "Cougar",
    "Puma",
    "Mountain Lion",
    "Catamount"
  ],
  "common_names_other_languages": {
    "Spanish": [
      "Puma",
      "onza bermeja"
    ]
  },
  "hierarchy": [
    {
      "name": "Animalia",
      "rank": "Kingdom",
      "tsn": "202423"
    },
    {
      "name": "Bilateria",
      "rank": "Subkingdom",
      "tsn": "914154"
    },
    {
      "name": "Deuterostomia",
      "rank": "Infrakingdom",
      "tsn": "914156"
    },
    {
      "name": "Chordata",
      "rank": "Phylum",
      "tsn": "158852"
    },
    {
      "name": "Vertebrata",
      "rank": "Subphylum",
      "tsn": "331030"
    },
    {
      "name": "Gnathostomata",
      "rank": "Infraphylum",
      "tsn": "914179"
    },
    {
      "name": "Tetrapoda",
      "rank": "Superclass",
      "tsn": "914181"
    },
    {
      "name": "Mammalia",
      "rank": "Class",
      "tsn": "179913"
    },
    {
      "name": "Theria",
      "rank": "Subclass",
      "tsn": "179916"
    },
    {
      "name": "Eutheria",
      "rank": "Infraclass",
      "tsn": "179925"
    },
    {
      "name": "Carnivora",
      "rank": "Order",
      "tsn": "180539"
    },
    {
      "name": "Feliformia",
      "rank": "Suborder",
      "tsn": "552304"
    },
    {
      "name": "Felidae",
      "rank": "Family",
      "tsn": "180580"
    },
    {
      "name": "Felinae",
      "rank": "Subfamily",
      "tsn": "552363"
    },
    {
      "name": "Puma",
      "rank": "Genus",
      "tsn": "552375"
    },
    {
      "name": "Puma concolor",
      "rank": "Species",
      "tsn": "552479"
    }
  ],
  "kingdom": "Animalia",
  "other_matches": [
    {
      "name": "Puma concolor azteca",
      "tsn": "552777"
    },
    {
      "name": "Puma concolor browni",
      "tsn": "552778"
    },
    {
      "name": "Puma concolor californica",
      "tsn": "552779"
    },
    {
      "name": "Puma concolor concolor",
      "tsn": "552780"
    },
    {
      "name": "Puma concolor coryi",
      "tsn": "552781"
    }
  ],
  "query": "Puma concolor",
  "rank": "Species",
  "scientific_name": "Puma concolor",
  "source": "Integrated Taxonomic Information System (ITIS)",
  "tsn": "552479"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://saylorinnovations.com/api/taxonomy/itis?name=Puma+concolor'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://saylorinnovations.com/api/taxonomy/itis?name=Puma+concolor' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fsaylorinnovations.com%2Fapi%2Ftaxonomy%2Fitis
const res = await pay("https://saylorinnovations.com/api/taxonomy/itis?name=Puma+concolor");
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
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

# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://saylorinnovations.com/api/taxonomy/itis?name=Puma+concolor")
    print(res.status_code, res.text)