---
title: "Create Bitcoin Transaction"
method: POST
path: "/api/v2/bitcoin/transactions"
tags: ["Bitcoin Transactions"]
---

# Create Bitcoin Transaction

`POST /api/v2/bitcoin/transactions`

Create a new Bitcoin transaction

## Headers

- `X-Network` 'testnet' | 'mainnet'
- `Authorization` string, required
- `Content-Type` 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data', required

## Request body

- object
  - `to` string, required — The address to send the transaction to. Must match the regex /^(bc1|tb1|[13])[a-zA-HJ-NP-Z0-9]{25,39}$/.
  - `amount` number, required — The amount to send.
  - `walletname` string, required — The name of the wallet to send the transaction from.
  - `password` string, required — The password to unlock the wallet.
  - `subtractfee` boolean — Whether to subtract the fee from the amount being sent.
  - `speed` 'fast' | 'medium' | 'slow', required — The speed of the transaction.

## Response `201`

Transaction created

- object
  - `status` integer
  - `ok` boolean
  - `message` string
  - `data` object
    - `txid` string

## Other responses

- `422` — Wrong password

---

[API](https://skmtc.net/chaingateway/apis/chaingateway-api-documentation.md) · [All operations](https://skmtc.net/chaingateway/apis/chaingateway-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chaingateway/chaingateway-api-documentation/revisions/ddb709b4ade7/schema)