---
name: sharesend-send-stock-gift
description: Send someone a slice of a US stock (tokenized on BNB Chain) as a claim link, paid over x402 (B402). Use when an agent should gift, reward or remit stock to a person.
---

# Send a stock gift with ShareSend

ShareSend buys a tokenized stock (bStocks or Ondo, on BNB Chain) for a recipient and gives you a claim link. The
recipient opens it on their phone and claims with their email: as shares, or as USDT. You pay over x402 v2; the
facilitator is Binance's B402, on BSC mainnet (`eip155:56`). Gifts are $1 to $20.

## 1. Ask for the price (optional)

    curl "https://sharesend-agent-production.up.railway.app/quote?ticker=NVDA&usd=5"

## 2. Open the gift: you get 402 Payment Required

    curl -i -X POST https://sharesend-agent-production.up.railway.app/gifts -H 'content-type: application/json' -d '{
      "ticker": "NVDA", "usd": 5,
      "senderAddress": "0xYourPayingAddress", "senderName": "Payroll bot",
      "recipientName": "Ada", "message": "Your first share, from the team"
    }'

The response has a `PAYMENT-REQUIRED` header (base64 JSON) and the same object in the body: `accepts` lists one
option per stablecoin. The price is held for a few minutes.

## 3. Sign one option and send the same request again

Sign with any x402 v2 client. With a Binance Agentic Wallet:

    baw x402-payment preview --paymentRequirements "<PAYMENT-REQUIRED header>" --json
    baw x402-payment sign --paymentId <paymentId> --selectedIndex <index> --json

Then repeat step 2 with the header `PAYMENT-SIGNATURE: <paymentHeaderValue>` and the same JSON body. The answer is
200 with `claimUrl` (shown once: deliver it to the recipient) and a `PAYMENT-RESPONSE` header with the settlement tx.

## 4. Follow the gift

    curl https://sharesend-agent-production.up.railway.app/gifts/<giftId>

Status goes PAID → BUYING → READY → CLAIMED. If it can't be bought, the full payment is refunded to the paying
address. Unclaimed gifts return to the paying address after 30 days.

## Rules

- `senderAddress` must be the address that signs the payment.
- The claim link is a secret: anyone with it can claim the gift. Send it only to the recipient.
- Tokenized US stocks aren't offered to people in the United States and some other countries; the recipient confirms
  their eligibility when claiming.