Testnet faucet
The faucet is the online on-ramp for building on TensorCash. It sends a small amount of testnet coins to any valid testnet address, so you can fund a wallet, exercise the JSON-RPC, and test model or asset flows against a live, shared chain. The coins have no value. For a fully offline sandbox with instant, unlimited coins, use the Regtest guide instead.
Get coins
POST your testnet address as JSON. No API key, no account. On success the response is the broadcast transaction id; follow it on the testnet explorer.
curl -sS -X POST https://mempool-testnet.tensorcash.org/api/v1/faucet \
-H 'Content-Type: application/json' \
-d '{"address": "<your-testnet-address>"}'
# {"txid":"…","address":"<your-testnet-address>","amount":"0.05"}No address yet? Any TensorCash wallet on testnet gives you one: getnewaddress over the JSON-RPC, or the receive screen of the desktop or mobile wallet.
Rate limits
The faucet is small on purpose: enough to unblock development, not enough to drain. If you need more than the cooldown allows, run Regtest guide and mine your own coins with no limits.
| Limit | Value | Detail |
|---|---|---|
| Drip | 0.05 TSC | The fixed amount sent per successful request. |
| Cooldown | 24 hours | Per address and per source IP, whichever was used more recently. A 429 carries a Retry-After header. |
| Daily cap | 5 TSC | The total the faucet dispenses per UTC day. Once it is reached, requests get a 429 until the next day. |
| Network | Testnet only | The address is checked against the testnet chain parameters, so a mainnet address is rejected. There is no mainnet faucet. |
Responses
Every response is JSON. The cooldown is only recorded on a confirmed send, so a transient failure never uses up your turn.
| HTTP | Body | When |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | Coins broadcast. The cooldown starts now. |
400 | { "error": "Provide a valid TensorCash testnet address." } | Missing or malformed address. |
400 | { "error": "That is not a valid TensorCash testnet address." } | Well formed, but not valid on testnet (for example a mainnet address). |
403 | { "error": "The faucet is available on testnet only." } | The request resolved to mainnet. |
429 | { "error": "You've already used the faucet recently.", "retry_after_secs": N } | Inside the 24 h cooldown for this address or IP. |
429 | { "error": "The faucet has hit its daily limit. Try again tomorrow." } | The 5 TSC daily cap is used up. |
503 | { "error": "The faucet is temporarily empty. Please try again later." } | The faucet wallet holds less than one drip plus fee. It is refilled by hand. |
Status
The faucet runs inside the testnet seed API. If that service is degraded, expect 503 responses from the faucet.
Where next
- Regtest guideThe offline path: your own local chain, instant coins, no limits, no network needed.
- JSON-RPC referenceThe full method index, including
getnewaddressto create the address you fund here.