Skip to main content
POST
Register Wallet
Endpoint: POST https://api.rebelfi.io/v1/wallets/register
Register a wallet address with your organization. Registration is idempotent — calling it again with the same address returns the existing wallet.

Request Body

FieldTypeRequiredDescription
walletAddressstringYesWallet address on the blockchain
blockchainstringYesBlockchain network: solana, polygon, ethereum, or base
userIdstringNoYour external user or account ID (for multi-wallet management)
orgMetadataobjectNoArbitrary metadata to store with the wallet

Example Request

Example Response

Response Fields

FieldTypeDescription
walletIdnumberWallet identifier (use for subsequent API calls)
walletAddressstringWallet address on the blockchain
blockchainstringBlockchain network
userIdstring?External user ID
orgMetadataobject?Organization-specific metadata
createdAtstringCreation timestamp (ISO 8601)
Registration is idempotent. If you register the same wallet address again, it returns the existing wallet without error.