/docs / faucet
Testnet faucet
The faucet is the online on-ramp for building against 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. Coins have no value. For a fully offline sandbox with instant, unlimited coins, use regtest instead.
testnet only · 0.05 TSC per drip · 24 h cooldown
Get coins
POST your testnet address as JSON. No API key, no account. On success the response is the broadcast transaction id — track 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"}
Don't have an address yet? Any TensorCash wallet on testnet gives you one
(getnewaddress over the JSON-RPC, or the
desktop / mobile wallet's receive screen).
Rate limits
The faucet is intentionally small — enough to unblock development, not to drain. If you need more than the cooldown allows, run regtest, where you mine your own coins with no limits.
| Limit | Value | Detail |
|---|---|---|
| Drip | 0.05 TSC | 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 | Total the whole faucet dispenses per UTC day. Once hit, requests 429 until the next day. |
| Network | testnet only | The address is checked against testnet chain params; a mainnet-format 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 burns 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 (e.g. a mainnet address). |
| 403 | { "error": "The faucet is available on testnet only." } | 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/day cap is exhausted. |
| 503 | { "error": "The faucet is temporarily empty. Please try again later." } | Faucet wallet balance is below the drip + fee. Refilled out of band. |
Status
The faucet runs inside the testnet seed API. Its health rolls up under
API · testnet on the
network status page,
alongside live testnet chain height and the explorers. If that service is
degraded, expect 503s from the faucet.
Where next
- /docs/regtest/ — the offline path: your own local chain, instant coins, no limits, no network required.
- /docs/rpc/
— full JSON-RPC index, including
getnewaddressto mint the address you fund here. - /status/ — live testnet health and uptime.