Get Smart Account

curl -X GET "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts?eoa=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&chain=8453&agent_id=giza-app" \
  -H "X-Partner-API-Key: your-api-key" \
  -H "X-Partner-Name: your-partner-name"

const params = new URLSearchParams({
  eoa: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
  chain: '8453',
  agent_id: 'giza-app',
});

const response = await fetch(
  `https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts?${params}`,
  {
    headers: {
      'X-Partner-API-Key': 'your-api-key',
      'X-Partner-Name': 'your-partner-name',
    },
  }
);

const data = await response.json();
console.log('Smart Account:', data.smartAccount);

import requests

response = requests.get(
    'https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts',
    headers={
        'X-Partner-API-Key': 'your-api-key',
        'X-Partner-Name': 'your-partner-name',
    },
    params={
        'eoa': '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
        'chain': 8453,
        'agent_id': 'giza-app',
    }
)

data = response.json()
print('Smart Account:', data['smartAccount'])

{
  "smartAccount": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
  "backendWallet": "0xDeF9876543210FeDcBa9876543210FeDcBa987654"
}

{
  "detail": "Smart account not found"
}

GET

api

proxy

zerodev

smart-accounts

curl -X GET "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts?eoa=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&chain=8453&agent_id=giza-app" \
  -H "X-Partner-API-Key: your-api-key" \
  -H "X-Partner-Name: your-partner-name"

const params = new URLSearchParams({
  eoa: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
  chain: '8453',
  agent_id: 'giza-app',
});

const response = await fetch(
  `https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts?${params}`,
  {
    headers: {
      'X-Partner-API-Key': 'your-api-key',
      'X-Partner-Name': 'your-partner-name',
    },
  }
);

const data = await response.json();
console.log('Smart Account:', data.smartAccount);

import requests

response = requests.get(
    'https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts',
    headers={
        'X-Partner-API-Key': 'your-api-key',
        'X-Partner-Name': 'your-partner-name',
    },
    params={
        'eoa': '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
        'chain': 8453,
        'agent_id': 'giza-app',
    }
)

data = response.json()
print('Smart Account:', data['smartAccount'])

{
  "smartAccount": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
  "backendWallet": "0xDeF9876543210FeDcBa9876543210FeDcBa987654"
}

{
  "detail": "Smart account not found"
}

SDK Alternative: Use giza.getAgent(eoa) or giza.getSmartAccount(eoa) for a simpler TypeScript interface. See SDK docs

Description

Looks up an existing smart account for a given EOA and chain. Returns the smart account address and backend wallet. Use this to retrieve a previously created smart account without creating a new one.

Query Parameters

eoa

string

required

The user’s externally owned account (wallet) address.

chain

integer

required

Chain ID to look up the smart account on.Supported values: 1 (Ethereum), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 84532 (Base Sepolia), 11155111 (Sepolia)

agent_id

string

Agent identifier. Defaults to giza-app.

Example Request

curl -X GET "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts?eoa=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&chain=8453&agent_id=giza-app" \
  -H "X-Partner-API-Key: your-api-key" \
  -H "X-Partner-Name: your-partner-name"

Response

smartAccount

string

The smart account address.

backendWallet

string

The Giza backend wallet associated with this smart account.

Response Example

{
  "smartAccount": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
  "backendWallet": "0xDeF9876543210FeDcBa9876543210FeDcBa987654"
}

Error Responses

Status	Description
`401`	Unauthorized - invalid API key
`404`	Smart account not found for this EOA and chain
`422`	Validation error (invalid address format)
`500`	Internal server error

curl -X GET "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts?eoa=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&chain=8453&agent_id=giza-app" \
  -H "X-Partner-API-Key: your-api-key" \
  -H "X-Partner-Name: your-partner-name"

const params = new URLSearchParams({
  eoa: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
  chain: '8453',
  agent_id: 'giza-app',
});

const response = await fetch(
  `https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts?${params}`,
  {
    headers: {
      'X-Partner-API-Key': 'your-api-key',
      'X-Partner-Name': 'your-partner-name',
    },
  }
);

const data = await response.json();
console.log('Smart Account:', data.smartAccount);

import requests

response = requests.get(
    'https://partners-backend-1038109371738.europe-west1.run.app/api/v1/proxy/zerodev/smart-accounts',
    headers={
        'X-Partner-API-Key': 'your-api-key',
        'X-Partner-Name': 'your-partner-name',
    },
    params={
        'eoa': '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
        'chain': 8453,
        'agent_id': 'giza-app',
    }
)

data = response.json()
print('Smart Account:', data['smartAccount'])

{
  "smartAccount": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
  "backendWallet": "0xDeF9876543210FeDcBa9876543210FeDcBa987654"
}

{
  "detail": "Smart account not found"
}

Create Smart Account Activate Wallet

​Description

​Query Parameters

​Example Request

​Response

​Error Responses

Description

Query Parameters

Example Request

Response

Error Responses