Wallet API

Manage your ETH wallet on Robinhood Chain.

Authentication

All endpoints require a Bearer token:

Authorization: Bearer <token>

Endpoints

Create Wallet

Create a new wallet for the authenticated user. A wallet is automatically created during account verification, but this endpoint can be used to create one manually if needed.

POST /wallet/create

Response:

{
  "publicKey": "0x1234...abcd",
  "mnemonic": "word1 word2 word3 ... word12"
}

danger

The mnemonic is only returned once during wallet creation. Store it securely and offline.

---

Get Balance

Check your current ETH balance on Robinhood Chain.

GET /wallet/balance

Response:

{
  "balance": 0.05432
}

The balance is returned as a number in ETH.

---

Get Recovery Phrase

Retrieve your encrypted mnemonic phrase.

POST /wallet/mnemonic

Request Body:

{
  "password": "your-email@example.com"
}

Response:

{
  "mnemonic": "word1 word2 word3 ... word12"
}

---

Send ETH

Send ETH to any address on Robinhood Chain.

POST /wallet/send

Request Body:

{
  "to": "0xRecipientAddress...",
  "amount": "0.01"
}

Validation:

• to must be a valid Ethereum address (matches 0x[a-fA-F0-9]{40})
• amount must be a positive number as a string

Response:

{
  "txHash": "0xabc123..."
}

---

Withdraw ETH

Withdraw ETH from your NeuroHash wallet to an external address.

POST /wallet/withdraw

Request Body:

{
  "to": "0xExternalAddress...",
  "amount": "0.01"
}

Response:

{
  "txHash": "0xdef456..."
}

Error Responses:

Status	Message
400	"Invalid Ethereum address"
400	"Insufficient balance"
400	"Amount must be greater than 0"

Network Details

All wallet operations occur on Robinhood Chain:

Property	Value
Chain ID	4663
RPC URL	https://rpc.mainnet.chain.robinhood.com
Block Explorer	https://robinhoodchain.blockscout.com
Transaction Confirmation	~100ms