---
updatedAt: 2026-03-05T09:17:43.000Z
agentTools:
  projectIndex: https://neutronpay.readme.io/llms.txt
---

# Get Bitcoin receive address

Retrieve the static Bitcoin on-chain address for the authenticated account.

Get your account's static Bitcoin on-chain deposit address. Any Bitcoin sent to this address is automatically credited to your Neutron BTC wallet.

### Example Request

```bash
curl "https://api.neutron.me/api/v2/account/onchain-address" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

### Example Response

```json
{
  "resultStatus": "success",
  "data": {
    "staticOnchainAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "accountId": "ne01-abc123def456"
  }
}
```

### Static vs Transaction Address

| Method                                                                             | Use when                                                                     |
| ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Static address** (this endpoint)                                                 | Persistent deposit address — use for recurring deposits, display in your app |
| **Transaction address** ([Receive Bitcoin On-Chain](/reference/btc-to-neutronpay)) | One-time address tied to a specific amount and quote                         |

The static address doesn't expire and can receive multiple deposits. Transaction-based addresses are linked to a specific transaction with a quoted amount and expiry.

### Notes

* The address is a **SegWit (bech32)** address starting with `bc1`
* Deposits require **on-chain confirmations** before funds appear in your wallet
* This is the same address shown in the Neutron dashboard
* One static address per account

### Related

* [Receive Bitcoin On-Chain](/reference/btc-to-neutronpay) — Create a transaction-based receive with a specific amount
* [Send Bitcoin On-Chain](/reference/neutronpay-to-btc) — Send BTC to an external address
* [Get USDT Receive Address](/reference/getusdtreceiveaddress) — USDT deposit address

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Neutron API",
    "description": "Neutron API for Bitcoin Lightning, on-chain, and stablecoin operations.\n\n**Base URLs:**\n- Production: `https://api.neutron.me`\n",
    "version": "2.2.6",
    "contact": {
      "email": "support@neutron.me",
      "url": "https://neutron.me"
    }
  },
  "servers": [
    {
      "url": "https://api.neutron.me",
      "description": "Production"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Addresses",
      "description": "Receive addresses for deposits"
    }
  ],
  "paths": {
    "/api/v2/account/onchain-address": {
      "get": {
        "tags": [
          "Addresses"
        ],
        "summary": "Get Bitcoin receive address",
        "description": "Retrieve the static Bitcoin on-chain address for the authenticated account.",
        "operationId": "getBitcoinReceiveAddress",
        "parameters": [
          {
            "name": "walletCcy",
            "in": "query",
            "required": true,
            "description": "Must be BTC",
            "schema": {
              "type": "string",
              "enum": [
                "BTC"
              ],
              "example": "BTC"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Address retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "resultStatus": {
                      "type": "string",
                      "example": "success"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "staticOnchainAddress": {
                          "type": "string",
                          "description": "Bitcoin deposit address",
                          "example": "3M5A4DZX8zcybTrH3ebR9ys2jYJZ8BzBBz"
                        },
                        "walletCcy": {
                          "type": "string",
                          "example": "BTC"
                        },
                        "accountId": {
                          "type": "string",
                          "example": "ne01-abc123"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "JWT access token from /api/v2/authentication/token-signature"
      }
    }
  }
}
```