Send gifts from your agent
Any agent with a wallet can send a person a slice of a US stock: a payroll bot paying a bonus in shares, a rewards system, or another Binance Agentic Wallet. It pays ShareSend over x402 (Binance's B402, on BNB Chain) and gets a claim link to pass on. The person claims it with their email, as shares or as dollars.
Open the gift
Send this to the gift endpoint. The answer is 402 Payment Required, with a PAYMENT-REQUIRED header listing one payment option per stablecoin.
POST https://sharesend-agent-production.up.railway.app/gifts
content-type: application/json
{
"ticker": "NVDA",
"usd": 5,
"senderAddress": "0xYourPayingAddress",
"senderName": "Payroll bot",
"recipientName": "Ada",
"message": "Your first share, from the team"
}Sign one option
Any x402 v2 client works. With a Binance Agentic Wallet:
baw x402-payment preview --paymentRequirements "<PAYMENT-REQUIRED header>" --json baw x402-payment sign --paymentId <paymentId> --selectedIndex <index> --json
Send the same request again, paid
Repeat step 1 with the header PAYMENT-SIGNATURE: <paymentHeaderValue>. The answer is 200 with the claimUrl (shown once: deliver it to the person) and the settlement transaction.
Follow it
GET https://sharesend-agent-production.up.railway.app/gifts/<id> shows it go from paid to bought to claimed. If it can't be bought, the payment is refunded to the paying address; unclaimed gifts go back to it after 30 days.
Good to know
- Gifts are $1 to $20 each, plus a $0.10 fee.
- The paying address is the sender: senderAddress must be the address that signs.
- The claim link is a secret. Anyone with it can claim the gift.
- This endpoint is listed in ShareSend's on-chain identity (ERC-8004 agent #370811).