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.

Testnet only · 0.05 TSC per request · 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; 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.

LimitValueDetail
Drip0.05 TSCThe fixed amount sent per successful request.
Cooldown24 hoursPer address and per source IP, whichever was used more recently. A 429 carries a Retry-After header.
Daily cap5 TSCThe total the faucet dispenses per UTC day. Once it is reached, requests get a 429 until the next day.
NetworkTestnet onlyThe 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.

HTTPBodyWhen
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 getnewaddress to create the address you fund here.