M10 OneSource Blockchain Agent

Ask natural language questions about Ethereum blockchain data. Covers historical on-chain activity (events, transactions, blocks, token transfers, NFTs), liv...

M10 Blockchain Agent

Ask a question in plain English. Get a structured analysis backed by live blockchain data — no query language, no SDKs, no index knowledge required.

Base URL	https://agent.onesource.io
Auth	HTTP 402 (x402 protocol, no API keys)
Price	$0.04 USDC per query
Networks	Ethereum mainnet · Sepolia · Avalanche

---

Payment

This is a paid endpoint. Requests without payment receive HTTP 402 with a payment-required header describing the price, network, and recipient. Paid requests include a payment-signature header and are processed normally.

Payment uses the x402 protocol — an open standard for HTTP-native payments. The skill itself does not manage wallets or signing; it only returns standard HTTP 402 responses. Payment handling is the responsibility of the calling client or platform.

---

Privacy & Data Handling

• Queries are sent to https://agent.onesource.io — an external service operated by OneSource. Your natural-language query text and any addresses you include are transmitted.
• query_traces in the response contains an audit trail of internal data lookups. This may echo parts of your query. Omit it from user-facing output if not needed.
• No data is stored beyond what is needed to process the request.

---

Capabilities

Indexed Historical Data

5.8 billion+ records across Ethereum mainnet, Sepolia testnet, and Avalanche C-Chain.

Events & Activity

• "How many Transfer events happened in the last 24 hours?"
• "What events did 0xdead... emit this week?"
• "Top 10 contracts by event count over the last 30 days"
• "Show me all Approval events for USDC in the last hour"

Transactions

• "What's the average gas used per transaction on mainnet today?"
• "How many transactions did 0xabc... send in the last 30 days?"
• "Show the 5 highest-value transactions in block range 21000000–21001000"
• "What's the transaction volume trend week over week for the last month?"

Blocks

• "What was the average block time last week?"
• "Which blocks had the highest gas utilization in the past 24 hours?"
• "How many blocks were produced per hour yesterday?"

Token Transfers (ERC-20 / ERC-721 / ERC-1155)

• "What ERC-20 tokens did 0xabc... receive in the last month?"
• "Top 5 ERC-20 tokens by transfer volume this week"
• "Show all mint events for USDC in the last 7 days"
• "How many unique wallets received WETH in the last 24 hours?"

NFTs

• "Show me BAYC token #4321 — name, image, and attributes"
• "What were the last 5 CryptoPunks sales and their prices?"
• "How many NFTs did 0xabc... receive this month?"
• "Top 10 NFT collections by transfer count today"

Contracts

• "When was Uniswap V3 deployed and who deployed it?"
• "How many contracts were deployed on mainnet in the last 7 days?"
• "Is 0xabc... a contract or an EOA?"

---

Live Chain State

Real-time lookups directly from Ethereum archive nodes — no indexing lag.

• "What's the current ETH balance of 0xabc...?"
• "What's the current gas price on mainnet?"
• "Did transaction 0x123... succeed or revert?"
• "What's the latest block number right now?"
• "What's the USDC balance of 0xabc... at the current block?"
• "How much ETH does Vitalik's address hold?"
• "What's the current EIP-1559 base fee and priority fee?"

---

Smart Contract Analysis

Analyze any deployed contract's bytecode — including unverified contracts — to extract its interface without needing source code.

• "What functions does 0xabc... expose?"
• "Decompile 0xabc... and show me the function selectors"
• "Compare the public functions of these two contracts: 0xabc... and 0xdef..."
• "Does 0xabc... implement ERC-721?"

---

Pricing

Requests are priced per-query at $0.04 USDC via the x402 payment protocol (see Payment above).

Network	Asset	Scheme	Endpoint
Base	USDC	exact	https://agent.onesource.io

The usage.estimated_cost_usd field in every response shows exactly what each query cost.

---

Request

POST /
Content-Type: application/json

{
  "query":      "string — required. Your natural language question.",
  "session_id": "string — optional. Custom ULID. Auto-generated if omitted."
}

Response

{
  "session_id": "01JMQX7K3N...",
  "status":     "completed | error | processing",
  "summary":    "Plain text summary, 1–3 sentences. Present on success.",
  "response":   "Full Markdown analysis with tables, headers, code blocks.",
  "steps": [
    {
      "agent":       "router | opensearch | rpc | evmole",
      "action":      "Description of what was queried",
      "status":      "completed | failed"
    }
  ],
  "usage": {
    "total_tokens":       5820,
    "estimated_cost_usd": 0.0018
  },
  "query_traces": [...],
  "error": "string | null"
}

summary — plain text, 1–3 sentences. Display this prominently. response — full Markdown. Render it, don't parse it as structured data. query_traces — raw audit trail of every data query made internally.

---

Error Codes

Code	Meaning	Fix
402	Payment required	Include payment-signature header
409	Session already exists	Omit session_id or use a new one
422	Malformed request	Check query field is present
500	Pipeline error	Try rephrasing the query

---

What M10 Won't Answer

The agent rejects queries requiring unbounded full-index scans with no filter:

• "List every transaction ever"
• "Give me all NFTs"
• "Show everything in the last year"

Add a filter (address, time range, event type, contract) and it works:

• "List the last 10 transactions from 0xabc..."
• "Top 10 NFT collections by mint count in the last 24 hours"
• "How many transactions happened last year?" (aggregation — fine)