> ## Documentation Index > Fetch the complete documentation index at: https://docs.rampapay.com/llms.txt > Use this file to discover all available pages before exploring further. # Get test tokens in your own wallet (sandbox only) > **Scope:** `wallet:write` Sends sandbox test tokens on Tron Shasta to a wallet **you** control — not your top-up address. Then send them from that wallet to your top-up address: once the transfer confirms on-chain, it is credited automatically. The faucet itself credits nothing. Limits: 100.00 per request, 1,000.00 and 10 requests per 24 hours, 1,000.00 per receiving address per 24 hours, 60 seconds between requests, and a daily total shared by every sandbox key. See [sandbox test data](/sandbox). ## OpenAPI ````yaml api-reference/openapi.json POST /sandbox/faucet openapi: 3.0.3 info: title: Rampa Pay API version: 1.0.0 description: >- Hold a USDT balance at Rampa and pay Bolivian merchant QRs in bolivianos. Amounts are decimal strings. servers: - url: https://examples.staging.rampapay.com/v1 description: 'Example server: sample answers, nothing real moves' security: - apiKey: [] tags: - name: Accounts description: Every balance you hold with Rampa, in one place. - name: Wallet description: Your USDT balance at Rampa, and how money gets into it. - name: Payouts description: >- Quote a BOB amount in USDT; once your end user accepts, pay it out at that quote from your USDT wallet — to a merchant QR today, to a bank account soon. - name: Webhooks description: Where we send events. Each endpoint gets its own signing secret. paths: /sandbox/faucet: post: tags: - Wallet summary: Get test tokens in your own wallet (sandbox only) description: >- **Scope:** `wallet:write` Sends sandbox test tokens on Tron Shasta to a wallet **you** control — not your top-up address. Then send them from that wallet to your top-up address: once the transfer confirms on-chain, it is credited automatically. The faucet itself credits nothing. Limits: 100.00 per request, 1,000.00 and 10 requests per 24 hours, 1,000.00 per receiving address per 24 hours, 60 seconds between requests, and a daily total shared by every sandbox key. See [sandbox test data](/sandbox). operationId: faucet parameters: - name: Idempotency-Key in: header required: true schema: type: string description: >- Required. Any unique string per attempt, e.g. a UUID. Retrying with the same key replays the first response and sends nothing. requestBody: required: true content: application/json: schema: type: object properties: chain: type: string enum: - tron description: '`tron`. Only Tron (Shasta) has a faucet.' address: type: string description: >- `base58 T…`. Your own Shasta wallet, the one you will send the top-up from. amount: type: string description: '`decimal string`. Up to 100.00, at most 2 decimals.' example: chain: tron address: TA4fxk7CkPHeyNbrXv6WfWtxoR49uQyw9z amount: '100.00' responses: '200': description: Sent content: application/json: schema: type: object properties: id: type: string status: type: string chain: type: string address: type: string amount: type: string tx_hash: type: string created_at: type: string remaining_today: type: string replayed: type: boolean example: id: 3b8f6d1a-9c2e-4f7b-8a5d-1e0c9b7a6f42 status: submitted chain: tron address: TA4fxk7CkPHeyNbrXv6WfWtxoR49uQyw9z amount: '100.00' tx_hash: >- 4a7d1e9c2b5f8036e1d4c7a9b2e5f8031c6d9a2e5b8f1c4d7a0e3b6c9f2a5d81 created_at: '2026-09-27T13:52:00.000Z' remaining_today: '900.00' replayed: false '400': description: >- The Idempotency-Key header is missing or longer than 255 characters, chain is not tron, or address is not a Tron address (T…). '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': description: No faucet in this environment (production never has one). '409': description: >- `IDEMPOTENCY_CONFLICT` — That Idempotency-Key was already used with a different request. '422': description: >- `AMOUNT_INVALID` — Not a positive amount with at most 2 decimals. `FAUCET_LIMIT_EXCEEDED` — Over 100.00 for one request (limit: per_request, with max_amount). `FAUCET_ADDRESS_IS_OURS` — That is a Rampa address, e.g. your top-up address. Use your own wallet. '429': description: >- `FAUCET_LIMIT_EXCEEDED` — Cooldown, your daily limit, the per-address limit or the shared daily total. limit says which; retry_after_seconds or remaining when it helps. '502': description: >- `FAUCET_SEND_FAILED` — Refused before anything was sent. Nothing counted against your limits; try again later. `FAUCET_SEND_UNCONFIRMED` — We could not confirm the send. Retry with the SAME Idempotency-Key: it never sends twice. '503': description: >- `FAUCET_EMPTY` — The faucet is out of test tokens. Tell Rampa. `FAUCET_UNAVAILABLE` — The faucet is not available right now. Try again later; tell Rampa if it persists. components: responses: Unauthorized: description: >- `AUTHENTICATION_FAILED` — the key is missing, unknown, revoked or expired, or the tenant is suspended. Forbidden: description: '`SCOPE_REQUIRED` — your key lacks this endpoint''s scope. Ask Rampa.' securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: >- On the example server, any key that starts with `rpk_mock_`, e.g. `rpk_mock_yourname`. Never your real key. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.