Register Wallet

Creates a wallet registration for the account.

A registered wallet address is used in orders settled in (self-)custodial wallets.

A wallet once registered under a defined chain and address is immutable. Only the primary status can be adjusted after creation.

POST /v1/accounts/{account_id}/wallets

Register Wallet

cURL

curl --request POST \
  --url https://sandbox.api.rime.finance/v1/accounts/{account_id}/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "polygon",
  "wallet_address": "0x1234..."
}
'

201

primary_wallet

{
  "id": "999e0123-e89b-12d3-a456-426614174004",
  "account_id": "123e4567-e89b-12d3-a456-426614174000",
  "chain": "polygon",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "is_primary": true
}

Authorizations

Authorization · string · header · required

Bearer access token. Provide as a Authorization: Bearer <token> header.

Path Parameters

account_id · string<uuid> · required

Body

application/json

chain · enum<string> · default: polygon · required

Blockchain network name. Currently only polygon is enabled.

Available options: polygon

wallet_address · string · required

Blockchain address for this wallet.

Example:

"0x1234..."

is_primary · boolean

Whether this is the primary/default resource for the account. Only one resource per account can be primary.

Example:

true

Response

201 - application/json

Wallet registered successfully

id · string<uuid>

Unique identifier for the resource.

Example:

"123e4567-e89b-12d3-a456-426614174000"

chain · enum<string> · default: polygon

Blockchain network name. Currently only polygon is enabled.

Available options: polygon

wallet_address · string

Blockchain address for this wallet.

Example:

"0x1234..."

is_primary · boolean

Whether this is the primary/default resource for the account. Only one resource per account can be primary.

Example:

true

created · string<date-time>

Timestamp when the resource was created.

Example:

"2024-01-15T10:30:00Z"