suix_getCoins | Alchemy Docs

1 import requests 2 3 url = "https://sui-mainnet.alchemy-blast.com/v2/:apiKey" 4 5 payload = { 6 "0": "0xe883a1df96561884e46d8e29cfb4e127bb6fd2719c33af1c16239a25a469e0a6", 7 "1": "0x2::sui::SUI", 8 "2": "0x1c574d9f2db5f293a799cc82795486aa8ce2962f831c7c6a433cbdcd84639acb", 9 "3": 3 10 } 11 headers = {"Content-Type": "application/json"} 12 13 response = requests.post(url, json=payload, headers=headers) 14 15 print(response.json())

1 { 2 "jsonrpc": "2.0", 3 "id": "1", 4 "result": { 5 "data": [ 6 { 7 "coinType": "0x2::sui::SUI", 8 "coinObjectId": "0xb770280feece9abe5f4683ee9a1b5baa76e3426d3dd46e9e17ae45a294d8a486", 9 "version": "2960614", 10 "digest": "CwcAqcZsw9toDkJjg2WjUvdY5U8o914CwzbTSUeEgPRR", 11 "balance": "1000000000", 12 "lockedUntilEpoch": null, 13 "previousTransaction": "DsYAh2efV1nD4UuEQXMeicPBgeYD4UbQSDpLg9mKTMzc" 14 } 15 ], 16 "nextCursor": "0xb770280feece9abe5f4683ee9a1b5baa76e3426d3dd46e9e17ae45a294d8a486", 17 "hasNextPage": false 18 } 19 }

Returns all Coin objects of the specified coin type owned by the given address. If the coin type is not provided, defaults to 0x2::sui::SUI.

⚠ This endpoint is only available with Blast access.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.

ownerstringRequired

The owner's Sui address.

coin_typestringOptional

Fully qualified type name of the coin (e.g., 0x2::sui::SUI). Defaults to 0x2::sui::SUI if omitted.

cursorstringOptional

Optional paging cursor to paginate results.

limitintegerOptional

Maximum number of items to return in a single page.

Response

A page of Coin objects and pagination metadata.

datalist of objects or null

List of Coin objects.

nextCursorstring or null

Cursor pointing to the next page of results, if any.

hasNextPageboolean or null

Whether there are more results available after this page.