Robinhood Chain testnet faucet and RPC: claim test ETH, then connect
Claim Robinhood Chain testnet ETH with your own API key (0.001 per claim). Testnet chain ID 46630, keyless RPC URL https://api.blockvectra.com/v1/robinhood_testnet/public; claim limits and error handling.
To claim Robinhood Chain testnet ETH, send POST https://api.blockvectra.com/v1/faucet/robinhood_testnet with your own API key in x-api-key and the recipient address in the JSON body; each accepted claim sends 0.001 test ETH, limited to one per account and one per address in a rolling 24 hours. The testnet RPC URL is https://api.blockvectra.com/v1/robinhood_testnet/public (chain ID 46630), keyless at 3 requests per second per IP; use it to confirm the claim after it is accepted. Checked .
Use the faucet to obtain test ETH for transactions on Robinhood Chain testnet (robinhood_testnet, chain ID 46630). Claiming is free and consumes no CU. For subsequent RPC calls, the keyless public endpoint supports the chain's public.methods from GET /v1/chains; RPC calls authenticated with an API key use normal CU billing.
- First step: Send a claim with your own API key and recipient address using the curl example below.
- Done when: HTTP
202and atx_hashconfirm acceptance; use the transaction-receipt query below to check on-chain inclusion before treating the claim as confirmed.
Testnet parameters and access options.
Before claiming
Register a BlockVectra account and use one of your own API keys. Create a key in the console or follow the programmatic sign-up guide.
Use 0x followed by 40 hexadecimal characters, either lowercase or mixed case with a valid EIP-55 checksum. Responses use lowercase addresses; different spellings of the same address share the same claim limit.
Send a claim
Call POST https://api.blockvectra.com/v1/faucet/robinhood_testnet with Content-Type: application/json and your key in x-api-key. This endpoint does not read a key from the URL path or Authorization.
Replace {api_key} with your key and the example address with your recipient address:
curl -i "https://api.blockvectra.com/v1/faucet/robinhood_testnet" \
-H "Content-Type: application/json" \
-H "x-api-key: {api_key}" \
-d '{"address":"0x1111111111111111111111111111111111111111"}'The JSON body contains only address and must fit within 64 KiB (see POST /v1/faucet/robinhood_testnet in the full OpenAPI reference). Unknown fields or invalid JSON return 400 invalid_request. Use the exact endpoint without query parameters.
Claim window and limits
- Each accepted claim sends 0.001 test ETH (
1000000000000000wei). - Each account and each recipient address can have one new claim per rolling 24 hours. Using another key on the same account does not increase the limit.
- The faucet accepts at most 1,000 new claims per UTC day across all users.
- Requests share a 5 requests per second per key limit with
/v1/account(seePOST /v1/faucet/robinhood_testnetin the full OpenAPI reference).
next_eligible_at is the acceptance time plus 24 hours, expressed as an RFC 3339 UTC timestamp. The account and address windows do not reset at UTC midnight. A claim-limit 429 includes error.data.scope (account, address, or global) and error.data.next_eligible_at; for global, the timestamp is the start of the next UTC day. A request-frequency 429 has no scope.
Accepted does not mean confirmed
HTTP 202 means accepted, not successfully included on-chain. The JSON response contains:
| Field | Meaning |
|---|---|
chain / chain_id | robinhood_testnet / 46630 |
address | Lowercase recipient address |
amount_wei | Claim amount as a decimal integer string |
tx_hash | Stable hash of the accepted transaction |
next_eligible_at | Next eligibility time for the rolling window |
Retrying the same normalized address from the same account within 24 hours returns the original 202 response and the same tx_hash, including when using another valid key from that account. It does not send another payment. If a response is lost, retry the same address with the same account.
Check the transaction using the existing testnet RPC endpoint. Replace {tx_hash} with the hash from the accepted response; this RPC query uses normal CU billing:
curl -s "https://api.blockvectra.com/v1/robinhood_testnet" \
-H "Content-Type: application/json" \
-H "x-api-key: {api_key}" \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionReceipt","params":["{tx_hash}"]}'Interpret the receipt result
Read the JSON-RPC body: HTTP 200 alone does not establish receipt or payment success.
| Response | Decision and action |
|---|---|
error | Query error. Follow the existing retry policy and error reference; do not mark the claim successful. |
result: null | Unconfirmed. No receipt was returned; this establishes neither success nor failure. Check tx_hash and robinhood_testnet, then repeat this query with backoff and a maximum attempt count or deadline. |
result.status = 0x1, blockHash != null, blockNumber != null | Execution succeeded. Included in a block and executed successfully; this is not Ethereum finality. |
result.status = 0x0 | Execution failed. Included in a block, but execution failed; do not count test ETH as received. |
| Other values or missing fields | Unconfirmed. Missing status or block information, or unexpected values, do not establish success. |
While waiting or after a timeout, keep the outcome unconfirmed and retain the original tx_hash; do not switch accounts or keys to claim again or bypass limits.
See Ethereum receipt fields and Robinhood confirmation levels.
Errors and retries
The error envelope contains error.code, error.message, and error.data. error.data.reason equals error.code; docs_url, retryable, and request_id provide the error reference, retry policy, and request identifier. For every 429 or 503, wait the number of seconds in the Retry-After response header before retrying. Without an accepted response, do not assume test ETH has been sent.
| HTTP | Error code | What to do |
|---|---|---|
| 400 | invalid_address | Correct the address format or EIP-55 checksum; error.data.field is /address. |
| 400 | invalid_request | Send valid JSON containing only address. |
| 401 | missing_api_key / invalid_api_key | Supply a valid key in x-api-key. |
| 403 | key_expired | Create a new API key. |
| 404 | not_found | Check the path, chain, POST method, and absence of query parameters; the faucet may be unavailable. |
| 413 | request_too_large | Reduce the body to fit within 64 KiB (see POST /v1/faucet/robinhood_testnet in the full OpenAPI reference). |
| 429 | rate_limited | Wait for Retry-After; inspect scope and next_eligible_at when present. |
| 503 | faucet_empty | The faucet has insufficient funds for the claim and fees. Wait for Retry-After. |
| 503 | service_unavailable | Claim processing is temporarily unavailable, or a previous claim has no receipt yet. Wait for Retry-After. |
| 503 | auth_unavailable / upstream_unavailable | Wait for Retry-After, then retry. |
See the error reference or /errors.json for machine-readable guidance, and the Robinhood Chain guide for RPC access.
Continue with the Robinhood Chain Testnet RPC starter for keyless reads and WebSocket logs. Find the public RPC URL and supported methods on the testnet chain page.
Last updated:
Robinhood Chain Testnet starter
Robinhood Chain testnet RPC URL https://api.blockvectra.com/v1/robinhood_testnet/public, chain ID 46630: keyless reads, WebSocket logs with an API key, faucet access, and switching the same key to mainnet.
Stock token multiplier
Understand the Robinhood Chain stock token multiplier, convert balances to shares, read uiMultiplier via eth_call, and track holders and daily activity via the Data API.