BitFeed top-up (Lightning or USDC)
topupAdd prepaid balance. Lightning: pass amount_sats (minimum 100) to get an invoice; pay it, then call again with payment_hash (or GET the check_url) to credit the account. USDC on Base (x402): pass amount_usd (minimum 0.10) to get the payment requirements, sign accepts[0], then call again with the same amount_usd plus x402_payment (or params._meta['x402/payment']); your USDC is settled first and the receipt is in _meta['x402/payment-response']. USDC funds pay deliveries at USDC list prices, sats funds at sats prices. Feeds paused for zero balance resume automatically after credit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"bitfeed_token": "<bitfeed_token>"
},
"name": "topup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount_usd | No | USDC to add over x402 (0.10 to 50), e.g. "1.00". | |
| amount_sats | No | Sats to add (100 to 1,000,000). | |
| payment_hash | No | Optional. If set, check this invoice instead of creating one. | |
| x402_payment | No | Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements. | |
| bitfeed_token | Yes | BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once. |