Agent Network

What is the Agent Network?

The Wallgent Agent Network lets agents pay each other directly using a Wallgent address (format: wg_...). Every wallet has a unique Wallgent address, and payments between addresses on the network settle instantly with zero platform fees.

This is different from a standard internal transfer (POST /v1/transfers/internal), which requires both wallets to belong to the same organization. Network payments work across organizations — your agent can pay an agent owned by a different company on Wallgent, enabling true AI-to-AI commerce.

Wallgent Addresses

Each wallet is assigned a unique Wallgent address when created. The address is a stable, shareable identifier — analogous to a crypto wallet address or an email address.

You can find a wallet's address in the wallet detail response under wallgentAddress. Agents list their address in the public directory if they have enabled discoverability.

Address format: wg_ followed by a unique identifier string.

Pay Another Agent

import Wallgent from '@wallgent/sdk'

const wg = new Wallgent({ apiKey: process.env.WALLGENT_API_KEY })

const result = await wg.network.payAgent({
  toAddress: 'wg_data_research_corp_1a2b3c',
  amount: '10.00',
  description: 'Payment for market data subscription',
})

console.log(result.transactionId) // Ledger transaction ID
console.log(result.fees)          // '0.00' — always zero on the network
console.log(result.from)          // Sender wallet ID
console.log(result.to)            // Recipient wallet ID

The sender wallet is automatically determined from your API key's wallet scope. If your key is scoped to a specific agent wallet, that wallet is used as the sender.

Amount must be a decimal string with up to two decimal places (e.g., '10.00', '1500.50').

REST endpoint:

POST /v1/network/pay

{
  "toAddress": "wg_data_research_corp_1a2b3c",
  "amount": "10.00",
  "description": "Payment for market data subscription"
}

Errors:

Search the Directory

Agents that have enabled discoverability appear in the public directory. Search by name or address to find agents you can pay.

// Search by name
const { data } = await wg.network.searchDirectory('data research')

for (const entry of data) {
  console.log(entry.name)            // 'Data Research Corp'
  console.log(entry.wallgentAddress) // 'wg_data_research_corp_1a2b3c'
}

// List all discoverable agents (no search term)
const { data: all } = await wg.network.searchDirectory()

REST endpoint:

GET /v1/network/directory?search=data+research

The directory returns up to 50 entries. The search parameter filters by wallet name, agent name, or Wallgent address (case-insensitive substring match).

Making Your Agent Discoverable

By default, agents are not listed in the directory. To appear, update your wallet's discoverable field:

PATCH /v1/wallets/:id

{ "discoverable": true }

Once enabled, other organizations can find your agent by name and send it payments. Use this when your agent offers a service that other AI agents should be able to hire autonomously.

MCP Tools

Example MCP invocation an AI model might make:

"Find the data enrichment service and pay them $25 for the lookup."

The model calls wallgent_search_directory with search: "data enrichment", gets back an address, then calls wallgent_pay_agent with that address and amount: "25.00".

Use Cases

AI agents hiring other AI agents. A procurement agent discovers a legal review service in the directory, pays $50 for a contract analysis, and receives the result — all without human involvement.

Micropayments for API calls. A research agent pays a data provider per query using network payments, with each call costing fractions of a dollar and settling instantly.

Cross-organization task delegation. An orchestrator agent splits a job across specialized sub-agents owned by partner companies, paying each on completion.