Skip to main content
DocketLayer queries are paid in USDC on Solana — $0.99 per query, settled on-chain via x402. Before your agent can make its first paid request, its wallet needs a USDC balance.

​
Step 1 — Create a Solana wallet

For agents that operate autonomously, generate a wallet programmatically. The private key is stored as an environment variable and the agent signs transactions automatically. 
import { Keypair } from "@solana/web3.js";

// Run once — save the output securely
const wallet = Keypair.generate();
console.log("Public key:", wallet.publicKey.toBase58());
console.log("Secret key:", Buffer.from(wallet.secretKey).toString("base64"));
Store the secret key as an environment variable: 
# .env — never commit this file
SOLANA_PRIVATE_KEY=your_base64_encoded_secret_key
Never hardcode your private key in source code or commit it to a repository. Use environment variables or a secrets manager.

​
Step 2 — Fund with USDC

Each query costs $0.99 in USDC on Solana. Options for funding: Buy USDC on an exchange — Purchase on Coinbase or Kraken and withdraw to your Solana wallet address. When withdrawing, confirm you select the Solana network — not Ethereum or any other chain. Swap SOL to USDC — Use Jupiter to swap SOL or any Solana token to USDC directly in your wallet. Verify your balance at Solana Explorer by searching your wallet’s public address.
Cases monitoredDaily queriesMonthly cost
1010~$30
100100~$300
1,0001,000~$3,000

​
Step 3 — Configure x402

import os
from x402 import PaymentClient

client = PaymentClient(
    private_key=os.environ["SOLANA_PRIVATE_KEY"],
    network="solana-mainnet",
    currency="USDC"
)

# Make a paid query
result = client.get(
    "https://api.docketlayer.com/v1/case",
    json={
        "case_id": "1:24-cv-01234",
        "court_code": "nysd",
        "last_checked": "2026-01-01T00:00:00Z"
    }
).json()

​
Step 4 — Test with the free endpoint

Before making paid queries, confirm connectivity: 
curl https://api.docketlayer.com/v1/status

​
Monitor your balance

A depleted wallet causes all queries to fail. Check your balance programmatically and alert when it falls below a threshold: 
from solana.rpc.api import Client
from spl.token.client import Token

def get_usdc_balance(wallet_address):
    # USDC mint address on Solana mainnet
    USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    # Use Solana Explorer or your preferred RPC to check balance
    pass

balance = get_usdc_balance(os.environ["SOLANA_PUBLIC_KEY"])
if balance < 10:
    send_alert("Wallet balance low — refund before next cycle")