> For the complete documentation index, see [llms.txt](https://docs.stacks.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stacks.co/reference/api/stacks-blockchain-api/faucets.md).

# Faucets

Endpoints to request STX or BTC tokens (not possible on Mainnet)

## Get BTC regtest or signet tokens

> Sends BTC to the specified regtest or signet BTC address. The response reports the amount sent, in satoshis, and the transaction id, which you can use to view the transaction in a regtest or signet Bitcoin block explorer. The tokens are delivered once the transaction has been included in a block.\
> \
> Each request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction.\
> \
> \*\*Note:\*\* This is a Bitcoin regtest/signet-only endpoint. This endpoint will not work on Bitcoin mainnet.

```json
{"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Faucets","description":"Endpoints to request STX or BTC tokens (not possible on Mainnet)"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/faucets/btc":{"post":{"operationId":"get_faucet_btc","summary":"Get BTC regtest or signet tokens","tags":["Faucets"],"description":"Sends BTC to the specified regtest or signet BTC address. The response reports the amount sent, in satoshis, and the transaction id, which you can use to view the transaction in a regtest or signet Bitcoin block explorer. The tokens are delivered once the transaction has been included in a block.\n\nEach request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction.\n\n**Note:** This is a Bitcoin regtest/signet-only endpoint. This endpoint will not work on Bitcoin mainnet.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"FaucetBtcRequest","type":"object","required":["address"],"properties":{"address":{"minLength":1,"description":"A valid regtest or signet BTC address","type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetBtcRun","type":"object","required":["transaction","amount"],"properties":{"transaction":{"type":"object","required":["tx_id","chain"],"properties":{"tx_id":{"pattern":"^0x[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID, `0x`-prefixed on both chains","type":"string"},"chain":{"description":"The chain the faucet transaction was broadcast to","type":"string","enum":["bitcoin"]}}},"amount":{"description":"The amount sent by the faucet","type":"object","required":["btc"],"properties":{"btc":{"pattern":"^[0-9]+$","title":"Amount","description":"The BTC sent by the faucet, in satoshis","type":"string"}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetError","type":"object","required":["error"],"properties":{"error":{"description":"Error message","type":"string"}}}}}},"5XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetError","type":"object","required":["error"],"properties":{"error":{"description":"Error message","type":"string"}}}}}}}}}}}
```

## Get STX testnet tokens

> Sends STX to the specified testnet address. Testnet STX addresses begin with \`ST\`. The response reports the amount sent, in µSTX, and the transaction id, which you can use to view the transaction in the \[Stacks Explorer]\(<https://explorer.hiro.so/?chain=testnet>). The tokens are delivered once the transaction has been included in a block.\
> \
> Each request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction.\
> \
> \*\*Note:\*\* This is a testnet only endpoint. This endpoint will not work on mainnet.

```json
{"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Faucets","description":"Endpoints to request STX or BTC tokens (not possible on Mainnet)"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/faucets/stx":{"post":{"operationId":"get_faucet_stx","summary":"Get STX testnet tokens","tags":["Faucets"],"description":"Sends STX to the specified testnet address. Testnet STX addresses begin with `ST`. The response reports the amount sent, in µSTX, and the transaction id, which you can use to view the transaction in the [Stacks Explorer](https://explorer.hiro.so/?chain=testnet). The tokens are delivered once the transaction has been included in a block.\n\nEach request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction.\n\n**Note:** This is a testnet only endpoint. This endpoint will not work on mainnet.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"FaucetStacksRequest","type":"object","required":["address"],"properties":{"address":{"minLength":1,"description":"A testnet Stacks address (`ST…` or `SN…`), or a contract principal deployed by one","type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetStxRun","type":"object","required":["transaction","amount"],"properties":{"transaction":{"type":"object","required":["tx_id","chain"],"properties":{"tx_id":{"pattern":"^0x[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID, `0x`-prefixed on both chains","type":"string"},"chain":{"description":"The chain the faucet transaction was broadcast to","type":"string","enum":["stacks"]}}},"amount":{"description":"The amount sent by the faucet","type":"object","required":["stx"],"properties":{"stx":{"pattern":"^[0-9]+$","title":"Amount","description":"The STX sent by the faucet, in µSTX","type":"string"}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetError","type":"object","required":["error"],"properties":{"error":{"description":"Error message","type":"string"}}}}}},"5XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetError","type":"object","required":["error"],"properties":{"error":{"description":"Error message","type":"string"}}}}}}}}}}}
```

## Get sBTC testnet tokens

> Sends sBTC to the specified testnet address. The endpoint performs a SIP-010 \`transfer\` contract call on the configured testnet sBTC token contract. Testnet STX addresses begin with \`ST\`. The response reports the amount sent, in satoshis, and the transaction id, which you can use to view the transaction in the \[Stacks Explorer]\(<https://explorer.hiro.so/?chain=testnet>). The tokens are delivered once the transaction has been included in a block.\
> \
> Each request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction.\
> \
> \*\*Note:\*\* This is a testnet only endpoint. This endpoint will not work on mainnet.

```json
{"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Faucets","description":"Endpoints to request STX or BTC tokens (not possible on Mainnet)"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/faucets/sbtc":{"post":{"operationId":"get_faucet_sbtc","summary":"Get sBTC testnet tokens","tags":["Faucets"],"description":"Sends sBTC to the specified testnet address. The endpoint performs a SIP-010 `transfer` contract call on the configured testnet sBTC token contract. Testnet STX addresses begin with `ST`. The response reports the amount sent, in satoshis, and the transaction id, which you can use to view the transaction in the [Stacks Explorer](https://explorer.hiro.so/?chain=testnet). The tokens are delivered once the transaction has been included in a block.\n\nEach request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction.\n\n**Note:** This is a testnet only endpoint. This endpoint will not work on mainnet.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"FaucetStacksRequest","type":"object","required":["address"],"properties":{"address":{"minLength":1,"description":"A testnet Stacks address (`ST…` or `SN…`), or a contract principal deployed by one","type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetSbtcRun","type":"object","required":["transaction","amount"],"properties":{"transaction":{"type":"object","required":["tx_id","chain"],"properties":{"tx_id":{"pattern":"^0x[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID, `0x`-prefixed on both chains","type":"string"},"chain":{"description":"The chain the faucet transaction was broadcast to","type":"string","enum":["stacks"]}}},"amount":{"description":"The amount sent by the faucet","type":"object","required":["sbtc"],"properties":{"sbtc":{"pattern":"^[0-9]+$","title":"Amount","description":"The sBTC sent by the faucet, in satoshis","type":"string"}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetError","type":"object","required":["error"],"properties":{"error":{"description":"Error message","type":"string"}}}}}},"5XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"FaucetError","type":"object","required":["error"],"properties":{"error":{"description":"Error message","type":"string"}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stacks.co/reference/api/stacks-blockchain-api/faucets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.