Skip to main content
POST
/
api
/
addresses
Create a new crypto address
curl --request POST \
  --url https://app.sandbox.rio.trade/api/addresses \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "address": "0x32Be343B94f860124dC4fEe278FDCBD38C102D88",
  "crypto": "USDC",
  "blockchainMemo": "1234567890",
  "userId": "66290ac8bd3903485989f82e",
  "label": "My Address"
}
'
{
  "createdAt": "2024-07-25T19:57:09.812Z",
  "userId": "66562bc04fe8bf83c577c178",
  "crypto": "USDC",
  "address": "0x32Be343B94f860124dC4fEe278FDCBD38C102D88",
  "blockchainMemo": "1234567890",
  "approved": false,
  "lastChecked": "2024-05-30T20:09:40.500Z",
  "label": "Crypto Address",
  "id": "6658dd0420b7daba6a25ff3a"
}

​
Requirements to consume the endpoint.

Create and modify role

The user must have the role to create and modify.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
address
string
required

New crypto address.

Example:

"0x32Be343B94f860124dC4fEe278FDCBD38C102D88"

​
crypto
enum<string>
required

Crypto currency.

Available options:
USDC,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
XLM_USDC_5F3T,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
blockchainMemo
string

The memo for the blockchain transaction (USDC Stellar addresses only). Please check if your wallet requires a memo for deposits. If so, please include the memo in the transaction. Failure to include the memo will result in the payment not being credited to your order and your funds may be permanently lost.

Example:

"1234567890"

​
userId
string

Id of the user to which this address will be associated.

Example:

"66290ac8bd3903485989f82e"

​
label
string

Label for the address.

Example:

"My Address"

Response

Created

​
createdAt
string

The date and time when the address was created.

Example:

"2024-07-25T19:57:09.812Z"

​
userId
string

Id of the user.

Example:

"66562bc04fe8bf83c577c178"

​
crypto
enum<string>

Crypto currency.

Available options:
USDC,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
XLM_USDC_5F3T,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
address
string

Crypto address.

Example:

"0x32Be343B94f860124dC4fEe278FDCBD38C102D88"

​
blockchainMemo
string

The memo for the blockchain transaction (USDC Stellar addresses only). Please check if your wallet requires a memo for deposits. If so, please include the memo in the transaction. Failure to include the memo will result in the payment not being credited to your order and your funds may be permanently lost.

Example:

"1234567890"

​
approved
boolean

Indicates if the address has been approved.

Example:

false

​
lastChecked
string

The date and time when the address was last verified.

Example:

"2024-05-30T20:09:40.500Z"

​
label
string

Label of the address.

Example:

"Crypto Address"

​
id
string

Id of the address.

Example:

"6658dd0420b7daba6a25ff3a"