---
name: x402-swarms-production.up.railway.app
description: This host provides two Solana-focused data endpoints: one that returns the current blockhash required to construct valid transactions, and one that retrieves paginated on-chain transaction history for a given wallet address (gated by a 0.01 USDC x402 payment). Both skills are read-only and do not submit or stream data.
host: x402-swarms-production.up.railway.app
---

# x402-swarms-production.up.railway.app

x402-swarms-production is a lightweight Solana utility host serving agents that need transaction construction prerequisites or historical wallet data. It targets agents operating in payment-gated API contexts using the x402 v2 protocol. It covers two narrow but distinct use cases: pre-transaction setup (blockhash retrieval) and post-transaction audit (history lookup). It does not provide RPC submission, balance queries, token pricing, or real-time data.

## When to use this host

Use this host when an agent needs to prepare a Solana transaction (requires a valid blockhash) or audit historical on-chain activity for a wallet address. The transaction history skill requires the agent to authorize a 0.01 USDC x402 payment, so only use it in contexts where that payment flow is supported. Do not use this host for submitting transactions (use a Solana RPC sendTransaction endpoint instead), streaming live transactions or balance changes (use a WebSocket-based RPC or indexer), token price or market data (use a dedicated price feed host), or any non-Solana chain data.

## Capabilities

### Transaction Construction Prerequisites

Provides the current blockhash and last valid block height needed to build and sign a Solana transaction before it is submitted to the network.

- **`fetch-solana-recent-blockhash`** — Returns the current Solana recent blockhash and last valid block height, required for constructing and signing Solana transactions.

### Wallet Transaction History

Retrieves paginated historical transaction records for a Solana wallet address, enabling audit, reconciliation, or activity analysis of past on-chain activity.

- **`fetch-solana-tx-history`** — Fetches paginated Solana transaction history for a given wallet address, gated by a 0.01 USDC SPL token payment via x402 v2.

## Workflows

### Pre-Transaction Audit and Build

*Use when an agent needs to review a wallet's recent transaction history before constructing a new transaction — for example, to check for duplicate submissions or confirm prior state before proceeding.*

1. **`fetch-solana-tx-history`** — Retrieve recent transaction history for the target wallet to verify prior activity or detect duplicate operations.
2. **`fetch-solana-recent-blockhash`** — Fetch a fresh blockhash to use when constructing and signing the new transaction after the history check is complete.

## Skill reference

### `fetch-solana-recent-blockhash`

**Solana Recent Blockhash** — Returns the current Solana recent blockhash and last valid block height, required for constructing and signing Solana transactions.

*Use when:* Use when an agent needs a fresh blockhash to build, sign, or serialize a Solana transaction before submission to the network.

*Not for:* Do not use for submitting or confirming transactions; use a Solana RPC sendTransaction or getSignatureStatuses call instead. Not suitable for continuous block monitoring.

**Returns:** Returns a blockhash string, lastValidBlockHeight integer, ISO timestamp, cached flag, and payment confirmation details for the 0.001 USDC x402 charge.

**Example:** `POST https://x402-swarms-production.up.railway.app/x402/recent-blockhash
Content-Type: application/json

{}`

---

### `fetch-solana-tx-history`

**x402 Tx History** — Fetches paginated Solana transaction history for a given wallet address, gated by a 0.01 USDC SPL token payment via x402 v2.

*Use when:* Use when an agent needs to retrieve the on-chain transaction history for a Solana address and can authorize a 0.01 USDC x402 payment to unlock the response.

*Not for:* Do not use for real-time transaction streaming or live balance lookups; this is a paginated historical query only.

**Inputs:**

- `address` (string, required) — Solana wallet address whose transaction history is being requested.
- `limit` (integer) — Number of transactions to return per page.
- `before` (string) — Pagination cursor — return transactions before this signature.

**Returns:** Returns a paginated array of Solana transaction records for the specified address, unlocked after a verified 0.01 USDC x402 payment.

**Example:** `{"address": "H1ooMkPx8uXoPS5WYz5JMY7dnYacqGLD3ZfEEku5caAZ", "limit": 10}`

---