Yes, a non-human agent can use a paid endpoint to read Solana mainnet balances. BuildAWallet provides a non-custodial API that allows autonomous agents to query live on-chain data using prepaid units. This guide covers how agents authenticate, query balances, and manage API keys without human intervention.

Paid Endpoint Access

BuildAWallet operates a machine-first platform where agents interact with blockchain data through a standardized interface. The platform separates human wallet design from machine API access. Agents do not need a checkout page or a human login. Instead, they use a prepaid unit system. One payment buys a block of API units for 30 days. Agents pay with USDC on Base or Solana. Once funded, the agent receives an API key. This key grants access to metered endpoints. Unused units roll over when the plan is renewed before expiry. This model removes the friction of per-transaction blockchain payments for simple data reads.

Prepaid Unit Model

The prepaid model is designed for high-frequency agent traffic. Agents consume units for each request. A single unit covers a full multichain portfolio query. This includes native and stablecoin balances on every network that accepts the address. The system ensures that agents can operate autonomously without constant human approval for data access. The dashboard tracks usage in real time. Agents can check their remaining units via a free endpoint. This transparency helps agents manage their own budget and avoid service interruptions.

Plan Tiers

BuildAWallet offers three main plan tiers for machine access. The Starter plan provides 100,000 units. The Pro plan offers 500,000 units. The Scale plan provides 2,000,000 units. Each plan is priced per 30 days. The cost per 1,000 units decreases as the plan size increases. This structure rewards agents with higher data consumption. All plans allow up to 10 active API keys. This flexibility supports complex agent architectures that may require multiple keys for different tasks or environments.

Agent Balance Queries

Agents can query Solana mainnet balances using specific REST endpoints. The primary endpoint for balance checks is GET /machine/v1/solana/wallet/{address}. This endpoint returns the live native balance for a given Solana address. It costs one unit per request. For a more comprehensive view, agents can use the snapshot endpoint. The snapshot endpoint is GET /machine/v1/solana/snapshot/{address}. It returns both native and stablecoin balances in a single call. This is useful for agents that need to assess total liquidity on the Solana network. The response includes the balance in the native token (SOL) and any canonical stablecoins (such as USDC) held by the address.

Portfolio Queries

For agents managing assets across multiple chains, the portfolio endpoint is the most efficient option. The endpoint is GET /machine/v1/portfolio/{address}. It queries native and stablecoin balances on every network that accepts the address. This includes Solana, Ethereum, Base, and other supported EVM chains. The entire multichain query costs only one unit. This efficiency is critical for agents that need to make rapid decisions based on cross-chain asset distribution. The response is structured to be easily parsed by machine learning models or rule-based logic engines.

Transaction Status

Agents can also monitor transaction status on Solana. The endpoint GET /machine/v1/solana/transaction/{tx} provides confirmation details for a specific transaction hash. This is useful for agents that have initiated a transfer and need to verify its finality. The endpoint costs one unit. It returns the transaction status, block height, and confirmation details. This allows agents to confirm that a payment has been settled before proceeding to the next step in their workflow.

Solana RPC Endpoints

BuildAWallet abstracts the complexity of direct Solana RPC calls. Instead of managing raw JSON-RPC requests, agents use a simplified REST API. This API handles the underlying RPC communication with Solana nodes. The platform supports ten mainnets, including Solana. For Solana, the API provides access to native balances and stablecoin data. The stablecoin data is limited to canonical assets, such as USDC. This ensures data consistency and reliability. Agents do not need to manage their own RPC node connections or handle rate limits from public RPC providers. The BuildAWallet API handles these infrastructure concerns, allowing agents to focus on their core logic.

Supported Networks

Data Accuracy

The API provides live on-chain data. Balances are read directly from the blockchain. This ensures that agents are working with the most current information. The data is accurate to the latest confirmed block. For Solana, this means agents can react to balance changes in near real-time. The API does not cache balance data for extended periods. This is important for agents that need to make time-sensitive decisions. The platform prioritizes data freshness over cost optimization for balance queries.

API Key Authentication

Key Management

Security Best Practices

Agents should treat API keys as sensitive credentials. They should never be committed to public code repositories. They should be stored in secure environment variables or secret management services. The API keys are hashed on the server side. This means that even if the database is compromised, the raw keys are not exposed. Agents should monitor their key usage regularly. The usage endpoint GET /machine/v1/usage provides a free way to check the remaining units and plan status. This helps agents detect any unauthorized usage or anomalies in their request patterns.

Comparison of Access Methods

Key Takeaways

• Agents can read Solana mainnet balances using the BuildAWallet paid API.
• The API uses a prepaid unit model, eliminating per-transaction blockchain payments for data reads.
• Authentication is handled via a bearer token API key passed in the HTTP header.
• The portfolio endpoint allows multichain balance queries for the cost of one unit.
• Agents can manage up to 10 active API keys per plan for flexible deployment.
• The API supports ten mainnets, including Solana, Ethereum, and Bitcoin.
• Unused units roll over when the plan is renewed before expiry.
• Agents should store API keys securely and monitor usage via the free usage endpoint.

Frequently Asked Questions

Can an agent read Solana balances without a human account?

Yes. Agents can create a wallet using the local kit or the server-made wallet endpoint. They can then purchase a plan with USDC and obtain an API key. This process does not require a human to manually manage the account.

How much does it cost to query a Solana balance?

Each balance query costs one unit. The cost per unit depends on the plan tier. For example, the Starter plan costs $15 for 100,000 units, which is $0.150 per 1,000 units.

Does the API support stablecoin balances on Solana?

Yes. The snapshot endpoint returns both native SOL and canonical stablecoin balances, such as USDC, in a single call.

Can agents use the API without a blockchain payment for each request?

Yes. The prepaid unit model allows agents to buy a block of units upfront. Subsequent requests deduct units from the account without requiring a new blockchain transaction.

How do agents authenticate to the API?

Agents use a bearer token API key. The key is passed in the Authorization header of each HTTP request. The key is generated from the account dashboard.

What happens when an agent runs out of units?

Metered calls return a 429 status code with usage details. No units are charged for the failed request. The agent can buy another plan from the dashboard to add units and extend the expiry.

Can agents use the API via MCP?

Yes. BuildAWallet provides an MCP server endpoint. Agents can connect to this endpoint to discover and call tools, including balance queries, using native tool calls.

Is the API non-custodial?

Yes. The API is non-custodial by default. Agents sign transactions locally. The platform never holds the agent's private keys or signs transactions on their behalf.

Conclusion

BuildAWallet provides a robust infrastructure for non-human agents to access Solana mainnet data. The paid API endpoints allow agents to read balances, check transaction status, and query portfolios using a simple prepaid unit model. By abstracting the complexity of RPC calls and handling authentication via standard API keys, BuildAWallet enables agents to operate autonomously and efficiently. For developers building autonomous financial agents, this platform offers the necessary tools to interact with the blockchain without human intervention. To start using the API, visit the BuildAWallet Machine dashboard and claim your free units.