Jump to

• Request
• Response

Get ERC20 Balance

get

/walletservice/v1/wallets/{walletAddress}/assets/erc20/{contractAddress}/balance

Retrieve the ERC-20 token balance for the specified wallet address and contract address.

Request

Path Parameters

• contractAddress(required): string
• walletAddress(required): string
  Wallet address in hex format (0x + 40 hex chars).

  Example:

  0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73

There's no request body for this operation.

Security

• bearerAuth: http
  Type: http

Back to Top

Response

Supported Media Types

• application/json

200 Response

Balance retrieved successfully.

Body ()

Root Schema : WalletBalanceResponse

Type: object

Show Source

• assetContract: string
  Example: 0x9a626f29784501056687dc267966dae6414cc91f
• assetType(required): string
  Example: native
• balance(required): string
  Example: 1000000000000000000
• updatedAt: string

{
    "type":"object",
    "properties":{
        "balance":{
            "type":"string",
            "example":"1000000000000000000"
        },
        "assetType":{
            "type":"string",
            "example":"native"
        },
        "assetContract":{
            "type":"string",
            "nullable":true,
            "example":"0x9a626f29784501056687dc267966dae6414cc91f"
        },
        "updatedAt":{
            "type":"string",
            "nullable":true
        }
    },
    "required":[
        "balance",
        "assetType"
    ]
}

400 Response

Bad request.

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Example: bad_request
• details: array details
• message(required): string
  Example: The request could not be processed.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "example":"bad_request"
        },
        "message":{
            "type":"string",
            "example":"The request could not be processed."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "message"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

500 Response

Internal server error.

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Example: bad_request
• details: array details
• message(required): string
  Example: The request could not be processed.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "example":"bad_request"
        },
        "message":{
            "type":"string",
            "example":"The request could not be processed."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "message"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Back to Top