Docs

accounts_resources

Get all on-chain resources under an account on Aptos

Overview

Lists all Move resources stored under an account. Useful to discover balances, capabilities, and custom module data.

Endpoint

GET /v1/accounts/{address}/resources

Aptos-Specific Notes

  • Resource types follow address::module::Struct<...>.
  • Large accounts may have many resources; use pagination parameters if present.

Request

Path Parameters

NameTypeRequiredDescription
addressstringYesAccount address (e.g., 0x1)

Query Parameters

NameTypeRequiredDescription
ledger_versionstringNoRead at a historical version
limitintegerNoMax number of resources to return
startstringNoCursor for pagination

Request Body

None.

Response

Success Response (200)

Text
[
  {
    "type": "0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>",
    "data": { "coin": { "value": "123" } }
  }
]

Error Responses

StatusError CodeDescription
400invalid_inputInvalid address format
404account_not_foundAccount doesn't exist

Code Examples

Text
curl -X GET https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1/accounts/0x1/resources?limit=100 \
  -H "Accept: application/json" \
  -H "Accept: application/json"

Common Use Cases

  • Token balances (CoinStore, FA)
  • Capability checks
  • Reading application state
  • accounts_resource - Get a single resource type