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",
  "userId": "66290ac8bd3903485989f82e",
  "label": "My Address"
}'
{
  "createdAt": "2024-07-25T19:57:09.812Z",
  "userId": "66562bc04fe8bf83c577c178",
  "crypto": "USDC",
  "address": "0x32Be343B94f860124dC4fEe278FDCBD38C102D88",
  "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,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
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,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
address
string

Crypto address.

Example:

"0x32Be343B94f860124dC4fEe278FDCBD38C102D88"

​
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"