Two-for-One Service

The two-for-one service lets an Agentlink-linked agent pay $1.00 USDC through x402 and receive up to $2.00 USDC back.

To qualify for the $2.00 payout, the human behind the agent must be actively biomapped with Humanode Biomapper on the target Base network, that Biomapper status must be visible there, and the paying agent wallet must be linked to that human through Agentlink.

How it works

1. Your agent calls POST /two-for-one.
2. Your agent pays $1.00 USDC through x402.
3. The request includes a signed agentlink header from the same wallet that paid.
4. The service checks whether that wallet is linked to an active biomapped human.
5. If eligible, the service sends $2.00 USDC back to the agent wallet.
6. If not eligible, the service sends $1.00 USDC back.

Before calling

To qualify for the $2.00 payout, complete the full setup:

1. Complete Humanode Biomapper as the human owner.
2. Bridge or publish the Biomapper status to Base Sepolia so the service can verify it.
3. Link the paying agent wallet to that biomapped owner with Agentlink.
4. Use that same agent wallet to pay x402 and sign the agentlink header.

Linking alone is not enough. The linked owner must be actively biomapped and visible on the target Base network when the request is made.

See Profile Support for the current Base and Base Sepolia registry and Bridged Biomapper status.

Eligibility

You receive $2.00 when:

• the human owner has completed Humanode Biomapper
• the human owner's active Biomapper status is available on Base Sepolia
• the agent wallet is linked to that biomapped owner
• this is that human's first two-for-one claim in the current Biomapper generation
• the x402 payer wallet and Agentlink signer wallet are the same wallet

The bonus is counted per human, not per agent wallet. If one human links multiple agent wallets, those agents share one two-for-one bonus per Biomapper generation.

Link the agent wallet

The wallet that pays x402 and signs the Agentlink header is the wallet that must be linked:

agentlink link --private-key 0xYourAgentPrivateKey --owner 0xOwnerWalletAddress --network base-sepolia --json
agentlink status --private-key 0xYourAgentPrivateKey --network base-sepolia --json

Use the owner wallet that completed Humanode Biomapper and bridged or published its status to Base Sepolia.

Calling the service

Your runtime needs to send:

• POST /two-for-one
• a valid x402 payment for $1.00 USDC
• a signed agentlink header from the same agent wallet

If your agent runtime already supports x402 payments and custom headers, no SDK-specific integration is required beyond adding the Agentlink identity header.

POST https://two-for-one.agentlink.id/two-for-one

Responses

Scenario	Payout	Meaning
Biomapped, bridged, linked agent; first eligible call this generation	$2.00	Bonus applied
Linked agent, repeat call for the same human	$1.00	Bonus already used
Unlinked, inactive, or not visible on Base Sepolia	$1.00	Not eligible for bonus

Responses include the payout amount and transaction hash.

Next: Link Your Agent, Self-Hosted Agent Operators, Add x402 Payments to Your Agent.