DocketLayer queries are paid in USDC on Solana — $0.99 per query, settled on-chain. Before your agent can make its first paid request, its wallet needs a USDC balance. This article covers every practical way to fund a Solana agent wallet, how much to fund for your query volume, and how to monitor the balance so your agent never runs dry.

What is USDC and why Solana?

USDC is a stablecoin pegged 1:1 to the US dollar, issued by Circle and redeemable for dollars at any time. It is the dominant stablecoin for agentic commerce — widely supported by exchanges, wallets, and payment protocols, and not subject to the price volatility of non-pegged cryptocurrencies. One USDC is always worth one dollar.

USDC exists on multiple blockchain networks, but DocketLayer uses USDC on Solana specifically. Solana's combination of high throughput (65,000+ transactions per second), near-instant finality, and sub-cent transaction fees makes it practical for per-request micropayments. A $0.99 query costs roughly $0.0005 in Solana network fees on top of the query price — negligible at any scale.

Network matters. When withdrawing USDC from an exchange or bridge, always confirm you are sending on the Solana network. USDC sent on Ethereum, Base, Polygon, or any other network will not arrive in your Solana wallet and cannot be used for DocketLayer queries.

Ways to fund your wallet

Simplest

Buy on Coinbase

Purchase USDC and withdraw directly to your Solana wallet address. Select "Solana" as the network when withdrawing.

coinbase.com →

Also reliable

Buy on Kraken

Purchase USDC and withdraw to your Solana address. Kraken supports Solana USDC withdrawals with competitive fees.

kraken.com →

If you hold SOL

Swap via Jupiter

Swap SOL or any Solana token to USDC using Jupiter's DEX aggregator. No KYC required, instant settlement.

jup.ag →

If you hold USDC elsewhere

Bridge from another chain

Use Wormhole or Circle's Cross-Chain Transfer Protocol to move USDC from Ethereum, Base, or another chain to Solana.

wormhole.com →

Step by step: buying USDC on Coinbase

This is the most common path for developers starting from zero.

  • Create a Coinbase account at coinbase.com and complete identity verification (required by regulation for fiat on-ramps).
  • Connect a bank account, debit card, or wire transfer and deposit USD. A bank ACH transfer is free; a debit card has a small fee but settles faster.
  • Buy USDC. On Coinbase, USDC is available with no conversion fee when bought with USD.
  • Go to Send/Receive, enter your agent wallet's Solana public address, set the network to Solana, and confirm. Withdrawals typically clear within a few minutes.
  • Verify receipt at Solana Explorer (explorer.solana.com) by searching your wallet's public address and checking the USDC token account balance.

Step by step: swapping SOL to USDC on Jupiter

If you already hold SOL in your agent wallet or another Solana wallet, swapping is faster than going through an exchange.

  • Go to jup.ag and connect your wallet (or enter your wallet address to preview rates without connecting).
  • Set the input token to SOL and the output token to USDC.
  • Enter the amount of SOL you want to swap. Jupiter aggregates rates across Solana DEXes and shows you the best available price.
  • Review the slippage tolerance (default 0.5% is fine for USDC) and confirm the swap.
  • USDC will appear in your wallet within seconds. Keep a small SOL balance — your wallet needs SOL to pay Solana network transaction fees (typically $0.0005 per transaction).

How much to fund

Fund your wallet with enough USDC to cover your expected query volume for at least one to two weeks, plus a buffer. Running out mid-workflow is disruptive — queries fail with payment errors, and your agent may miss filings in the gap.

Cases monitored Query frequency Monthly cost Two-week buffer
10Daily~$30~$15
50Daily~$150~$75
100Daily~$300~$150
500Daily~$1,500~$750
1,000Daily~$3,000~$1,500

DocketLayer does not charge for queries that return an error or for queries to the free /v1/status endpoint. You pay only for successful docket data responses.

Monitoring your balance

Your agent should check its wallet balance before or after each monitoring cycle and alert you when the balance falls below a threshold. Here is a simple balance check using the Solana web3.js library:

import { Connection, PublicKey } from "@solana/web3.js"; import { getAssociatedTokenAddress, getAccount } from "@solana/spl-token"; const USDC_MINT = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"); async function getUsdcBalance(walletAddress) { const connection = new Connection("https://api.mainnet-beta.solana.com"); const wallet = new PublicKey(walletAddress); const tokenAccount = await getAssociatedTokenAddress(USDC_MINT, wallet); const accountInfo = await getAccount(connection, tokenAccount); // USDC has 6 decimal places return Number(accountInfo.amount) / 1_000_000; } const balance = await getUsdcBalance(process.env.SOLANA_PUBLIC_KEY); console.log(`Wallet balance: $${balance.toFixed(2)} USDC`); if (balance < 50) { // Send alert — email, Slack, PagerDuty, etc. console.warn("Low wallet balance — refund before next cycle"); }

Run this check at the start of each monitoring cycle. If the balance is below your threshold, skip the cycle and send an alert rather than letting the agent proceed and fail mid-run.

Multiple wallets for high volume

DocketLayer enforces a rate limit of 10,000 queries per day per wallet. For workflows requiring more than 10,000 daily queries, distribute load across multiple funded wallets. Each wallet is independent — generate separate keypairs, fund them separately, and route queries across them in your agent's request logic.

Further reading