Get Owned Objects

POST

https://iota.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed. Pagination fix: a page no longer skips an unchanged entry when the dynamic field or object referenced by the cursor was removed, transferred or otherwise left the index between two requests. Results that were previously missing when paging are now returned.

Return the list of objects owned by an address. Note that if the address owns more than QUERY_MAX_RESULT_LIMIT objects, the pagination is not accurate, because previous page may have been updated when the next page is fetched. Please use iotax_queryObjects if this is a concern.

Body

application/json

JSON-RPC request for iotax_getOwnedObjects.

Structured JSON-RPC request information.

jsonrpcstring2.0required

JSON-RPC protocol version.

idintegerrequired

Client-defined identifier used to match the response to the request.

methodstringiotax_getOwnedObjectsrequired

IOTA JSON-RPC method name.

paramsArray<any>required

Ordered positional parameters supplied to the method.

Response

200OK

Successful JSON-RPC response returned by the node.

Get Owned Objects

curl -X POST 'https://iota.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "iotax_getOwnedObjects",
    "params": [
      "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
      {
        "options": {
          "showType": true,
          "showOwner": true,
          "showContent": true
        }
      },
      null,
      2
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://iota.nownodes.io/");
const result = await provider.send("iotax_getOwnedObjects", [
  "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
  {
    "options": {
      "showType": true,
      "showOwner": true,
      "showContent": true
    }
  },
  null,
  2
]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://iota.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "iotax_getOwnedObjects",
  "params": [
    "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
    {
      "options": {
        "showType": true,
        "showOwner": true,
        "showContent": true
      }
    },
    null,
    2
  ],
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://iota.nownodes.io/"))
response = w3.provider.make_request("iotax_getOwnedObjects", [
  "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
  {
    "options": {
      "showType": True,
      "showOwner": True,
      "showContent": True
    }
  },
  null,
  2
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://iota.nownodes.io/"),
});

const result = await client.request({
  method: "iotax_getOwnedObjects",
  params: [
  "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
  {
    "options": {
      "showType": true,
      "showOwner": true,
      "showContent": true
    }
  },
  null,
  2
],
});

console.log(result);

const endpoint = "https://iota.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "iotax_getOwnedObjects", params: [
  "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
  {
    "options": {
      "showType": true,
      "showOwner": true,
      "showContent": true
    }
  },
  null,
  2
], id: 1 });
console.log(result);

const response = await fetch('https://iota.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "iotax_getOwnedObjects",
      "params": [
        "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
        {
          "options": {
            "showType": true,
            "showOwner": true,
            "showContent": true
          }
        },
        null,
        2
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "iotax_getOwnedObjects",
  "params": [
    "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
    {
      "options": {
        "showType": True,
        "showOwner": True,
        "showContent": True
      }
    },
    null,
    2
  ]
}

response = requests.post('https://iota.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://iota.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "iotax_getOwnedObjects",
    "params": [
      "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
      {
        "options": {
          "showType": true,
          "showOwner": true,
          "showContent": true
        }
      },
      null,
      2
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "iotax_getOwnedObjects",
  "params": [
    "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff",
    {
      "options": {
        "showType": true,
        "showOwner": true,
        "showContent": true
      }
    },
    null,
    2
  ]
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": [
      {
        "data": {
          "objectId": "0x13b4b8eeb6273b9f68d41c07b7350d386b6baf507b391616ddcf90550d0157c1",
          "version": "394340779",
          "digest": "9YtAgVp4gQafHHDP7qbB6AkS9WBUCFuAaNNyScUEu5Yi",
          "type": "0x6d2c743607ef275bd6934fe5c2a7e5179cca6fbd2049cfa79de2310b74f3cf83::name_registration::NameRegistration",
          "owner": {
            "AddressOwner": "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff"
          },
          "content": {
            "dataType": "moveObject",
            "type": "0x6d2c743607ef275bd6934fe5c2a7e5179cca6fbd2049cfa79de2310b74f3cf83::name_registration::NameRegistration",
            "fields": {
              "expiration_timestamp_ms": "1799744903315",
              "id": {
                "id": "0x13b4b8eeb6273b9f68d41c07b7350d386b6baf507b391616ddcf90550d0157c1"
              },
              "name": {
                "type": "0x6d2c743607ef275bd6934fe5c2a7e5179cca6fbd2049cfa79de2310b74f3cf83::name::Name",
                "fields": {
                  "labels": [
                    "iota",
                    "nansen"
                  ]
                }
              },
              "name_str": "nansen.iota"
            }
          }
        }
      },
      {
        "data": {
          "objectId": "0x16b925d82891832ba72c7396201a08a9c9d70c99db3b2cce8ad8a296c65d1af0",
          "version": "788292160",
          "digest": "CABLV2P9fK8nTiDMdJVe26aCYHeQgmK8wbctiqSFSCDt",
          "type": "0x3::staking_pool::StakedIota",
          "owner": {
            "AddressOwner": "0xa69363ce32b9b1e5b9c7480232ca6799068daa7c22c3d8cc53632246c354b9ff"
          },
          "content": {
            "dataType": "moveObject",
            "type": "0x3::staking_pool::StakedIota",
            "fields": {
              "id": {
                "id": "0x16b925d82891832ba72c7396201a08a9c9d70c99db3b2cce8ad8a296c65d1af0"
              },
              "pool_id": "0x650976e1fcdc34715fcd3c3fc855fe53f8fb1975d71ef0a14c70def314f29cd0",
              "principal": "2040220000170",
              "stake_activation_epoch": "495"
            }
          }
        }
      }
    ],
    "nextCursor": "0x16b925d82891832ba72c7396201a08a9c9d70c99db3b2cce8ad8a296c65d1af0",
    "hasNextPage": true
  }
}