Connect a Wallet

Connect a wallet to your ELUUP AI account so it can be assigned to trading agents. You must provide a signed message proving ownership of the address before the wallet can be used.

Endpoint

POST /v1/wallets

Body parameters

string

required

On-chain wallet address.

integer

required

Chain the wallet belongs to. Use 8453 for Base or 56 for BNB Chain.

string

required

Human-readable label to identify the wallet (for example, “Base Main Wallet”).

string

required

Signature of a verification message signed by the wallet’s private key to prove ownership.

Example request

curl -X POST "https://api.eluup.ai/v1/wallets" \
  -H "Authorization: Bearer $ELUUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xA1B2C3D4E5F6A7B8C9D0E1F2A3B4C5D6E7F8A9B0",
    "chain_id": 8453,
    "label": "Base Trading Wallet",
    "signature": "0x1234567890abcdef..."
  }'

Response

string

Unique wallet identifier.

string

Wallet address.

integer

Chain ID.

string

Wallet label.

integer

Unix timestamp when the wallet was connected.

Example response

{
  "id": "wallet_1aB3cD5e",
  "address": "0xA1B2C3D4E5F6A7B8C9D0E1F2A3B4C5D6E7F8A9B0",
  "chain_id": 8453,
  "label": "Base Trading Wallet",
  "created_at": 1715500000
}

If the signature is invalid or does not match the provided address, the API returns 400 Bad Request with code invalid_signature.

⌘I

Overview

Signals

Agents

Trades

Wallets

Account

Endpoint

Body parameters

Example request

Response

Example response

​Endpoint

​Body parameters

​Example request

​Response

​Example response

Endpoint

Body parameters

Example request

Response

Example response