API reference
The Octaze REST API (v1).
All endpoints live under https://app.octaze.dev/api/v1 and require an API key:
curl https://app.octaze.dev/api/v1/testnets \
-H "Authorization: Bearer $OCTAZE_API_KEY"Errors return { "error": "..." } with an appropriate status. Requests are rate-limited per key (429 with Retry-After when exceeded).
Testnets
| Method | Path | Body | Description |
|---|---|---|---|
POST | /testnets | { name, network? } | Create a testnet |
GET | /testnets | — | List testnets |
GET | /testnets/{id} | — | Get a testnet |
DELETE | /testnets/{id} | — | Delete a testnet |
Faucet
| Method | Path | Body |
|---|---|---|
POST | /testnets/{id}/faucet | { address, amount } (SOL) or { address, mint, amount, decimals, symbol? } (token) |
Transactions
| Method | Path | Body | Description |
|---|---|---|---|
POST | /testnets/{id}/simulate | { transaction } (base64) | Simulate |
POST | /testnets/{id}/send | { transaction } (base64, signed) | Send |
GET | /testnets/{id}/transactions | — | List transactions |
GET | /transactions/{sig}?testnet={id} | — | Full trace |
Authentication
Send the key as a bearer token (Authorization: Bearer ok_…) or X-Api-Key. Keys are created and scoped (all / selected projects / none) from the dashboard.