One Trading API
REST API
WebSocket API
REST API
WebSocket API
  1. Funding
  • Public
    • Currencies
      GET
    • Instruments
      GET
    • Candlesticks
      GET
    • Fee Groups
      GET
    • Order Book
      GET
    • Market Ticker
      GET
    • Market Ticker For Instrument
      GET
    • Time
      GET
  • Trading
    • Get Orders
      GET
    • Create Order
      POST
    • Get Order by Client ID
      GET
    • Get Order by Order ID
      GET
    • Balances
      GET
    • Subaccounts
      GET
    • Fees
      GET
    • Get Trades for Order
      GET
    • Get Trade by Trade ID
      GET
    • Get Trades
      GET
    • Cancel All Orders
      DELETE
    • Cancel Order by Order ID
      DELETE
    • Cancel Order by Client ID
      DELETE
  • Futures
    • Introduction
    • Funding Rate Methodology
    • Funding Payments
      GET
    • Positions
      GET
    • Position Funding Payments
      GET
    • Funding Rate Settings
      GET
    • Get Futures Open Positions
      GET
    • Futures Portfolio Summary
      GET
    • Current Funding Rate
      GET
    • Funding Rate History
      GET
    • Funding Schedule
      GET
  • Funding
    • Transfer Subaccount Balance
      POST
    • Get Transactions
      GET
    • Get Deposit Addresses
      GET
    • Create Deposit Address
      POST
  1. Funding

Create Deposit Address

Developing
POST
https://api.onetrading.com/fast/v1/account/deposit-addresses
Generates your account's deposit address for a currency, or returns the one it already has.
201 Created: a new address was generated.
200 OK: you already had an address for the currency; it comes back unchanged. Calling again is safe.
A first address can take several seconds to generate.
network is optional and defaults to the currency's default network (is_default in GET /v1/currencies). For now, addresses can only be generated on the default network; any other network answers 400 NETWORK_NOT_SUPPORTED.
Send the currency only on the returned network, and include destination_tag with every deposit when it is set; see GET /v1/account/deposit-addresses.

Requirements#

A main-account token: deposit addresses belong to your main account, and deposits to them are credited to it. A subaccount token gets 403 SUBACCOUNT_NOT_SUPPORTED.
An API key with the TRADE or WITHDRAW scope, or a user session.
An active, verified account (403 ACCOUNT_NOT_ELIGIBLE otherwise), with deposits of the currency enabled for it (403 DEPOSITS_NOT_ENABLED otherwise).
Rate limited.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200OK
application/json
You already had an address for the currency; it is returned unchanged.
Bodyapplication/json

🟢201Created
🟠400Bad Request
🟠403Forbidden
🟠409Conflict
🟠429Too Many Requests
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.onetrading.com/fast/v1/account/deposit-addresses' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "BTC"
}'
Response Response Example
200 - Success Example
{
    "currency": "BTC",
    "network": "BITCOIN",
    "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "destination_tag": null,
    "destination_tag_type": null,
    "created_at": "2026-11-04T10:00:00.000Z",
    "deposit_enabled": true
}
Previous
Get Deposit Addresses
Built with