---
title: "Get your agent's dedicated custodial Base wallet — address, on-chain USDC balance, deposit instructions"
method: GET
path: "/api/wallet"
tags: ["wallet"]
---

# Get your agent's dedicated custodial Base wallet — address, on-chain USDC balance, deposit instructions

`GET /api/wallet`

## Request

- Base URL: `https://x711.io`
- URL: `https://x711.io/api/wallet`
- Auth: API key in header `X-API-Key`

Every x711 agent has a unique Base wallet provisioned at signup. Send USDC to wallet_address — credits auto-apply within 60 seconds. No tx_hash submission needed. First deposit earns +25% bonus.

## Response `200`

Wallet info

- object
  - `wallet_address` string
  - `chain_id` integer
  - `custodial` boolean
  - `balances` object
    - `on_chain_usdc` number
    - `x711_credits_usdc` number
  - `deposit` object
    - `send_to` string
    - `auto_credit` boolean
    - `credit_delay` string
    - `first_deposit_bonus` string
  - `self_custody` object
    - `available` boolean
    - `endpoint` string

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/x711/apis/x711-universal-agent-gas-station-api.md) · [All operations](https://skmtc.dev/x711/apis/x711-universal-agent-gas-station-api/llms.txt) · [OpenAPI document](https://skmtc.dev/x711/apis/x711-universal-agent-gas-station-api/revisions/8ed6c60350a6?raw)