Skip to main content
POST
/
v1
/
wallets
/
register
Register Wallet
curl --request POST \
  --url https://api.example.com/v1/wallets/register
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

curl -X POST "https://api.rebelfi.io/v1/wallets/register" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "So11...abc",
    "blockchain": "solana",
    "userId": "user-123",
    "orgMetadata": { "plan": "premium" }
  }'

​
Example Response

{
  "walletId": 42,
  "walletAddress": "So11...abc",
  "blockchain": "solana",
  "userId": "user-123",
  "orgMetadata": { "plan": "premium" },
  "createdAt": "2024-01-15T10:30:00.000Z"
}

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