Dedsol
  • 👀 | Overview
  • Indexer
    • 👉 | Getting Started
    • 🌐 | Rest Endpoints
      • Getting Started
      • Endpoints
    • 🔮 | GraphQL
      • Getting Started
      • Playground (GraphiQL)
    • 💰 | Pricing
      • Enteprise Plan
      • How Crediting Works
  • Miscellaneous
    • 🧭 | Roadmap
    • 🫡 | Team
    • 🤖 | Discord
    • 📍 | Directory
    • ❤️ | Support Us
Powered by GitBook
On this page
  • Before Getting Started
  • Latest Endpoints
  • Metadata
  • Accounts
  • Tokens
  • Transactions
  • Native Pools
  • NFT Collections
  • Resource Holders
  • Resource Holders
  • Token Balances
  • Validators
  • Vaults
  1. Indexer
  2. 🌐 | Rest Endpoints

Endpoints

All available endpoint for fetching data on Radix with our REST API.

PreviousGetting StartedNext🔮 | GraphQL

Last updated 2 months ago

Before Getting Started

Checkout our documentation explaining how our REST function .

Latest Endpoints

Metadata

POST /v1/metadata

Fetch metadata for entities on Radix.

Parameters

  • addresses (optional list of strings)

    • Addresses to filter by

  • entity_ids (optional list of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "addresses": [
    "package_rdx1pkgxxxxxxxxxtxnpxrxxxxxxxxx002962227406xxxxxxxxxtxnpxr"
  ],
  "entity_ids": [ 12 ]
}
Example Response
{
  "data": [
    {
      "entity_id": 4,
      "address": "package_rdx1pkgxxxxxxxxxtxnpxrxxxxxxxxx002962227406xxxxxxxxxtxnpxr",
      "key": "name",
      "value": "\"Transaction Processor Package\"",
      "is_locked": true,
      "is_deleted": false,
      "discriminator": "GlobalPackage"
    },
    {
      "entity_id": 4,
      "address": "package_rdx1pkgxxxxxxxxxtxnpxrxxxxxxxxx002962227406xxxxxxxxxtxnpxr",
      "key": "description",
      "value": "\"A native package that defines the logic of the processing of manifest instructions and transaction runtime.\"",
      "is_locked": true,
      "is_deleted": false,
      "discriminator": "GlobalPackage"
    },
    {
      "entity_id": 12,
      "address": "package_rdx1pkgxxxxxxxxxplxxxxxxxxxxxxx020379220524xxxxxxxxxplxxxx",
      "key": "name",
      "value": "\"Pool Package\"",
      "is_locked": true,
      "is_deleted": false,
      "discriminator": "GlobalPackage"
    },
    {
      "entity_id": 12,
      "address": "package_rdx1pkgxxxxxxxxxplxxxxxxxxxxxxx020379220524xxxxxxxxxplxxxx",
      "key": "description",
      "value": "\"A native package that defines the logic for a selection of pool components.\"",
      "is_locked": true,
      "is_deleted": false,
      "discriminator": "GlobalPackage"
    }
  ],
  "pagination": {...}
}

Accounts

POST /v1/accounts

Fetch accounts and their settings on the Radix network.

Parameters

  • addresses (optional list of strings)

    • Addresses to filter by

  • entity_ids (optional List of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "addresses": [
    "account_rdx168pkkmthyvlvs58qzxxfmaf6nhqtnrfec5tkyp0a9qsgfhy7w4nfdj",
  ],
  "entity_ids": [
    42
  ]
}
Example Response
{
  "data": [
    {
      "id": 42,
      "address": "account_rdx169yzkrr5p93e3hgx4t2p4ngh2tt0ldscrtjve4yyt902a7whhzrfu9",
      "created_at": "2023-09-28T06:33:34.721Z",
      "default_deposit_rule": "accept",
      "resource_preference_rules": null,
      "authorized_depositors": null
    },
    {
      "id": 19599,
      "address": "account_rdx168pkkmthyvlvs58qzxxfmaf6nhqtnrfec5tkyp0a9qsgfhy7w4nfdj",
      "created_at": "2023-09-28T06:33:34.721Z",
      "default_deposit_rule": "accept",
      "resource_preference_rules": null,
      "authorized_depositors": "[{\"resource_id\" : 20, \"discriminator\" : \"resource\"}]"
    }
  ],
  "pagination": {...}
}

Tokens

POST /v1/tokens

Fetch tokens deployed on the Radix network.

Parameters

  • addresses (optional list of strings)

    • Addresses to filter by

  • entity_ids (optional List of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "addresses": [
    "resource_rdx1tkvg5j0kumr9za0huphf9du8k62vz9ypv8ex2hfmu5e46kz9pz68el"
  ],
  "entity_ids": [ 910141 ]
}
Example Response
{
  "data": [
    {
      "resource_id": 66093,
      "resource_address": "resource_rdx1tkvg5j0kumr9za0huphf9du8k62vz9ypv8ex2hfmu5e46kz9pz68el",
      "resource_divisibility": 18,
      "supply_changed_at": 510,
      "total_minted": "3141000000000000000000",
      "total_burned": "0",
      "total_supply": "3141000000000000000000",
      "name": "\"🧮 Pi\"",
      "name_is_locked": false,
      "tags": null,
      "tags_is_locked": null,
      "symbol": "\"pi\"",
      "symbol_is_locked": false,
      "icon_url": "\"https://radixical.com/icon\"",
      "icon_url_is_locked": false,
      "info_url": "\"https://radixical.com\"",
      "info_url_is_locked": false,
      "description": "\"The beauty of math and science in it's most abstract and surreal form.  Pi\"",
      "description_is_locked": false,
      "all_metadata": "{ \"description\" : \"\\\"The beauty of math and science in it's most abstract and surreal form.  Pi\\\"\", \"icon_url\" : \"\\\"https://radixical.com/icon\\\"\", \"info_url\" : \"\\\"https://radixical.com\\\"\", \"name\" : \"\\\"🧮 Pi\\\"\", \"symbol\" : \"\\\"pi\\\"\" }"
    },
    {
      "resource_id": 910141,
      "resource_address": "resource_rdx1thd8llpatuqmzt0366zk97ccsttyw7yw2puwqtckmv0mykf53tnche",
      "resource_divisibility": 18,
      "supply_changed_at": 18131186,
      "total_minted": "22360679774997896964",
      "total_burned": "0",
      "total_supply": "22360679774997896964",
      "name": null,
      "name_is_locked": null,
      "tags": null,
      "tags_is_locked": null,
      "symbol": null,
      "symbol_is_locked": null,
      "icon_url": null,
      "icon_url_is_locked": null,
      "info_url": null,
      "info_url_is_locked": null,
      "description": null,
      "description_is_locked": false,
      "all_metadata": "{ \"pool\" : \"\\\"NodeId(c5aa3d907f060e5953a260b0c39ec1e459f4a6a09c2a3b3cca8a60dda7d4)\\\"\" }"
    }
  ],
  "pagination": {
    "next_cursor": null,
    "total_count": null
  }
}

Transactions

POST /v1/transactions

Fetch transactions on the Radix network.

Parameters

  • intent_hash (optional list of strings)

    • Intent has of transaction to filter by

  • state_version (optional List of integers)

    • State version of transaction to filter by

If both parameters are provided then it will return accounts with specified intent hash OR state version.

Example Request
{
  "intent_hashes": [
    "txid_rdx174zzww0amy2y6m9te00rtas3wwu9979txsgnkwuf0z8976yvysrsn5mz69"
  ],
  "state_versions": [ 10398 ]
}
Example Response
{
  "data": [
    {
      "intent_hash": "txid_rdx174zzww0amy2y6m9te00rtas3wwu9979txsgnkwuf0z8976yvysrsn5mz69",
      "state_version": 10146,
      "epoch": 32736,
      "fee_paid": "461382538390000000",
      "tip_paid": "0",
      "round_timestamp": "2023-09-28T09:40:15.659Z",
      "created_timestamp": "2024-12-23T16:10:46.896929Z",
      "receipt_status": "Succeeded",
      "receipt_fee_summary": "{\"xrd_total_royalty_cost\": \"0\", \"xrd_total_storage_cost\": \"0.12140273839\", \"xrd_total_tipping_cost\": \"0\", \"xrd_total_execution_cost\": \"0.30872255\", \"xrd_total_finalization_cost\": \"0.03125725\", \"execution_cost_units_consumed\": 6174451, \"finalization_cost_units_consumed\": 625145}",
      "balance_changes": "{\"fungible_entity_balance_changes\": [{\"entity_address\": \"account_rdx168mkavkk66e9hve5uhjqppwvwx4xpdk45vwkkc9e53qr8h6dcpgd4x\", \"fee_balance_change\": {\"balance_change\": \"-0.46138253839\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}, \"fee_balance_changes\": [{\"type\": \"FeePayment\", \"balance_change\": \"-0.46138253839\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}], \"non_fee_balance_changes\": [{\"balance_change\": \"20\", \"resource_address\": \"resource_rdx1thlnv2lydu7np9w8guguqslkydv000d7ydn7uq0sestql96hrfml0v\"}]}, {\"entity_address\": \"consensusmanager_rdx1scxxxxxxxxxxcnsmgrxxxxxxxxx000999665565xxxxxxxxxcnsmgr\", \"fee_balance_change\": null, \"fee_balance_changes\": [{\"type\": \"FeeDistributed\", \"balance_change\": \"0.230691269195\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}], \"non_fee_balance_changes\": []}], \"non_fungible_entity_balance_changes\": []}",
      "discriminator": "User",
      "message": "Have some GC tokens on the house!",
      "raw_payload": "5c78346432323033303232313032323130343231303730373031306165303766303030303030303030303030306165613766303030303030303030303030303966623265306638323232303130313230303732306261623563323261383639393561623765346264613530363637313664353264656435623936346432633263613463343465343863316631316639343561616330313030303830303030323032323034343130333830303064316637366562326436643662323562623333346535653430303835636337316161363062366435613331643662363062396134343033336466346430633038366336663633366235663636363536353231303138356530633332363465393966623137303830303030303030303030303030303030303030303030303030303030303030303431303338303030633064626365373065306637386436396131323733383739376536633631303230313661343038353462313232643339643231343233663631396634306331323634363937333730363536653733363535663637363335663734366636623635366537333231303030303032383030303564666633363262653436663364333039356337343731316330343366363233353866376264626532333637656530316630636331363066393735373835303030306430313330393436386531353031303030303030303030303030303030303030303030303030303030303030343130333830303064316637366562326436643662323562623333346535653430303835636337316161363062366435613331643662363062396134343033336466346430633037363436353730366637333639373432313031383130303030303030303230323030303232303130313231303230633034373436353738373432323030303130633231343836313736363532303733366636643635323034373433323037343666366236353665373332303666366532303734363836353230363836663735373336353231323032323031303030313231303132303037343130313936353866333566346239363066613563646333323634306330646439303138623466386133613239643063303538613664306538666630326337613933373931626339643437303831396665653561393265336436373535636438326130633164396434376130323164393032643335636263316436323635373034643139323230313031323130313230303734306265363363613932643338383963663730653134373539396166393339613234653631326465623164393138303263383665303461376131343661613366316662643535626532306633346235313833313531363331363631653934306238366133383662613233383833646434306236376632333063626130376433333063",
      "manifest_instructions": "CALL_METHOD\n    Address(\"account_rdx168mkavkk66e9hve5uhjqppwvwx4xpdk45vwkkc9e53qr8h6dcpgd4x\")\n    \"lock_fee\"\n    Decimal(\"0.5832113126275\")\n;\nCALL_METHOD\n    Address(\"component_rdx1crduuu8q77xkngf88puhumrpqgqk5sy9fvfz6wwjzs3lvx05z3582h\")\n    \"dispense_gc_tokens\"\n;\nTAKE_FROM_WORKTOP\n    Address(\"resource_rdx1thlnv2lydu7np9w8guguqslkydv000d7ydn7uq0sestql96hrfml0v\")\n    Decimal(\"20\")\n    Bucket(\"bucket1\")\n;\nCALL_METHOD\n    Address(\"account_rdx168mkavkk66e9hve5uhjqppwvwx4xpdk45vwkkc9e53qr8h6dcpgd4x\")\n    \"deposit\"\n    Bucket(\"bucket1\")\n;\n"
    },
    {
      "intent_hash": "txid_rdx13g5hu3tcwa0psvc6y3drgql6pw563mcr25tt8wz9a8hcmfks9mdqqm9djv",
      "state_version": 10398,
      "epoch": 32737,
      "fee_paid": "458631530480000000",
      "tip_paid": "0",
      "round_timestamp": "2023-09-28T09:42:20.367Z",
      "created_timestamp": "2024-12-23T16:10:46.953007Z",
      "receipt_status": "Succeeded",
      "receipt_fee_summary": "{\"xrd_total_royalty_cost\": \"0\", \"xrd_total_storage_cost\": \"0.20370483048\", \"xrd_total_tipping_cost\": \"0\", \"xrd_total_execution_cost\": \"0.2034156\", \"xrd_total_finalization_cost\": \"0.0515111\", \"execution_cost_units_consumed\": 4068312, \"finalization_cost_units_consumed\": 1030222}",
      "balance_changes": "{\"fungible_entity_balance_changes\": [{\"entity_address\": \"account_rdx1693zpzjqknmcwt0x08yaurv4kpdna7san9xfkh92sm0et6fkfqwqav\", \"fee_balance_change\": {\"balance_change\": \"-0.45863153048\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}, \"fee_balance_changes\": [{\"type\": \"FeePayment\", \"balance_change\": \"-0.45863153048\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}], \"non_fee_balance_changes\": [{\"balance_change\": \"-1841867.803473014894729051\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}]}, {\"entity_address\": \"account_rdx12yj5c5j3zhkd4hnx567e03stwgyy7vqgfaw5lh3uukdz5vtavf4pfj\", \"fee_balance_change\": null, \"fee_balance_changes\": [], \"non_fee_balance_changes\": [{\"balance_change\": \"1841867.803473014894729051\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}]}, {\"entity_address\": \"consensusmanager_rdx1scxxxxxxxxxxcnsmgrxxxxxxxxx000999665565xxxxxxxxxcnsmgr\", \"fee_balance_change\": null, \"fee_balance_changes\": [{\"type\": \"FeeDistributed\", \"balance_change\": \"0.22931576524\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}], \"non_fee_balance_changes\": []}], \"non_fungible_entity_balance_changes\": []}",
      "discriminator": "User",
      "message": null,
      "raw_payload": "5c7834643232303330323231303232313034323130373037303130616531376630303030303030303030303030616562376630303030303030303030303030396330616635353934323230313031323030373230653532306462343530616134653432313231643136653031303965383333383766316663316436643966333939636562393539386437316638356633623038343031303030383030303032303232303434313033383030306431363232303861343062346637383732646536373963396465306439356230356233656661316439393463396235636161383664663935653933363063303836633666363336623566363636353635323130313835383038353666653163653334363630383030303030303030303030303030303030303030303030303030303030303030343130333830303064313632323038613430623466373837326465363739633964653064393562303562336566613164393934633962356361613836646639356539333630633038373736393734363836343732363137373231303238303030356461363633313863363331386336316635613631623463363331386336333138636637393461613864323935663134653633313863363331386336383535623937623531626439663038626461303738363031303030303030303030303030303030303030303030303030303030303032383030303564613636333138633633313863363166356136316234633633313863363331386366373934616138643239356631346536333138633633313863363835356239376235316264396630386264613037383630313030303030303030303030303030303030303030303030303030343130333830303035313235346335323531313565636461646536366136626439376336306237323038346633303038346635643466646533636535396132613331376430633037363436353730366637333639373432313031383130303030303030303230323030303232303030303230323230323030303132313031323030373431303039636132303432326561663664646631633438623431663934313463656161316430656665653233663663653136323337346534343739303335366166353637363132356361636133653761663564663866366234633936653732333734626261656365323131346334356138336138376134393833643763396432626464303031303232303037323032626231316161383535623061613864343630303531383164316637633065386561653365636635633666343535346364643131313135363764323934616430323130313230303734303136643835376161396565613734386562646539366137316631663631666332313136376561323963343661346133313563323732373435336137373230643561373562663037353433613436653862646566633136656235626461343933636361646236323139636561313261363339353333323166393364653063663061323230313031323130313230303734303439373761353561626134613332343032646135376365353465323636396437666664376633396466303166313664333264313436313166616537313064613963376135343837383432616663666330363166373664383863646530366530376434366264376434613839316266333939376430656132616434303364303066",
      "manifest_instructions": "CALL_METHOD\n    Address(\"account_rdx1693zpzjqknmcwt0x08yaurv4kpdna7san9xfkh92sm0et6fkfqwqav\")\n    \"lock_fee\"\n    Decimal(\"0.605229263078\")\n;\nCALL_METHOD\n    Address(\"account_rdx1693zpzjqknmcwt0x08yaurv4kpdna7san9xfkh92sm0et6fkfqwqav\")\n    \"withdraw\"\n    Address(\"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\")\n    Decimal(\"1841867.803473014894729051\")\n;\nTAKE_FROM_WORKTOP\n    Address(\"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\")\n    Decimal(\"1841867.803473014894729051\")\n    Bucket(\"bucket1\")\n;\nCALL_METHOD\n    Address(\"account_rdx12yj5c5j3zhkd4hnx567e03stwgyy7vqgfaw5lh3uukdz5vtavf4pfj\")\n    \"deposit\"\n    Bucket(\"bucket1\")\n;\n"
    }
  ],
  "pagination": {...}
}

Native Pools

POST /v1/native-pools

Fetch native pools on the Radix network.

Parameters

  • addresses (optional list of strings)

    • Addresses to filter by

  • entity_ids (optional List of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "addresses": [
    "pool_rdx1c5x3dgpt7g4m5pks89g2n93x5m8tj5859x9jzq3lnxhu7es0ln80m9"
  ],
  "entity_ids": [ 920099 ]
}
Example Response
{
  "data": [
    {
      "id": 917660,
      "address": "pool_rdx1c5x3dgpt7g4m5pks89g2n93x5m8tj5859x9jzq3lnxhu7es0ln80m9",
      "discriminator": "GlobalTwoResourcePool",
      "state": "{\"vaults\": [{\"is_global\": false, \"entity_type\": \"InternalFungibleVault\", \"entity_address\": \"internal_vault_rdx1tzyr8vtf4n46sr2r69jl64g0d3h3367hdj8yzrd2vaalc0458mzzd9\", \"resource_address\": \"resource_rdx1t4km4k306ul40s3zr8zwwrm25xfmx7w8ytjvdwqh0u3kkch0eph9rn\"}, {\"is_global\": false, \"entity_type\": \"InternalFungibleVault\", \"entity_address\": \"internal_vault_rdx1trthv4q3la05fp9k9musgncv5htcrt82rf38x97q4c9aysz8qaxn5l\", \"resource_address\": \"resource_rdx1t5ywq4c6nd2lxkemkv4uzt8v7x7smjcguzq5sgafwtasa6luq7fclq\"}], \"pool_unit_resource_address\": \"resource_rdx1t5e2kz3hl3akuygna7398xgulp5tp4call2x90x5njfgw2qa5usana\"}",
      "unit": "\"NodeId(5d32ab0a37fc7b6e1113efa253991cf868b0d71dffd462bcd49c9287281d)\"",
      "resource": "[\"NodeId(5d6dbada2fd73f57c22219c4e70f6aa193b379c722e4c6b8177f236b62ef)\",\"NodeId(5d08e0571a9b55f35b3bb32bc12cecf1bd0dcb08e0814823a972fb0eebfc)\"]",
      "vault_number": "\"2\"",
      "dapp_definition": null,
      "all_metadata": "{ \"pool_resources\" : \"[\\\"NodeId(5d6dbada2fd73f57c22219c4e70f6aa193b379c722e4c6b8177f236b62ef)\\\",\\\"NodeId(5d08e0571a9b55f35b3bb32bc12cecf1bd0dcb08e0814823a972fb0eebfc)\\\"]\", \"pool_unit\" : \"\\\"NodeId(5d32ab0a37fc7b6e1113efa253991cf868b0d71dffd462bcd49c9287281d)\\\"\", \"pool_vault_number\" : \"\\\"2\\\"\" }",
      "created_at": "2023-11-24T16:06:41.114Z"
    },
    {
      "id": 920099,
      "address": "pool_rdx1c544dvvmcn38fprhu3xguuvxzrpkggdnkh9uv87t5kfzlfwc08atum",
      "discriminator": "GlobalTwoResourcePool",
      "state": "{\"vaults\": [{\"is_global\": false, \"entity_type\": \"InternalFungibleVault\", \"entity_address\": \"internal_vault_rdx1tzyn3ft86ww6puhflf7dd3px968dgdtlqnj5z0erpr7gpx86um2fmp\", \"resource_address\": \"resource_rdx1t4ze583gr09r9nr2asf87khcp88lc7vcf3hdapdjhcgzvapzqgarar\"}, {\"is_global\": false, \"entity_type\": \"InternalFungibleVault\", \"entity_address\": \"internal_vault_rdx1tzysql8hrnghssd76dg0mcad44237f55ekkh55wc7jpjcjxxccxqj6\", \"resource_address\": \"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd\"}], \"pool_unit_resource_address\": \"resource_rdx1thfcl00wxcxacgthvkzqtyxzcdlsw4k0yng9s2pcs9eehg84p2yys8\"}",
      "unit": "\"NodeId(5dd38fbdee360ddc217765840590c2c37f0756cf24d058283881739ba0f5)\"",
      "resource": "[\"NodeId(5d459a1e281bca32cc6aec127f5af809cffc79984c6ede85b2be10267422)\",\"NodeId(5da66318c6318c61f5a61b4c6318c6318cf794aa8d295f14e6318c6318c6)\"]",
      "vault_number": "\"2\"",
      "dapp_definition": "\"NodeId(51959c4a360d77701791a986dbfa721104fcbb02ac04c7c9d495a0634213)\"",
      "all_metadata": "{ \"dapp_definition\" : \"\\\"NodeId(51959c4a360d77701791a986dbfa721104fcbb02ac04c7c9d495a0634213)\\\"\", \"pool_resources\" : \"[\\\"NodeId(5d459a1e281bca32cc6aec127f5af809cffc79984c6ede85b2be10267422)\\\",\\\"NodeId(5da66318c6318c61f5a61b4c6318c6318cf794aa8d295f14e6318c6318c6)\\\"]\", \"pool_unit\" : \"\\\"NodeId(5dd38fbdee360ddc217765840590c2c37f0756cf24d058283881739ba0f5)\\\"\", \"pool_vault_number\" : \"\\\"2\\\"\" }",
      "created_at": "2023-11-25T21:05:46.716Z"
    }
  ],
  "pagination": {...}
}

NFT Collections

POST /v1/nft-collections

Fetch NFT collections on the Radix Network.

Parameters

  • addresses (optional list of strings)

    • Addresses to filter by

  • entity_ids (optional List of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "addresses": [
    "resource_rdx1n2lkpedsng026dwu4kw0kh6xksq4wycn8kv6ks3erf6yges45f85d6"
  ],
  "entity_ids": [ 878314 ]
}
Example Response
{
  "data": [
    {
      "id": 883121,
      "address": "resource_rdx1n2lkpedsng026dwu4kw0kh6xksq4wycn8kv6ks3erf6yges45f85d6",
      "non_fungible_id_type": "string",
      "created_at": "2023-11-02T15:18:56.158Z",
      "supply_changed_at": 12559672,
      "total_minted": "1000000000000000000",
      "total_burned": "0",
      "total_supply": "1000000000000000000",
      "name": "\"TROVE Key: rippy for you\"",
      "description": "\"Your Swap Proposal on trove.tools\"",
      "icon_url": "\"https://trove.tools/TroveSquare.png\"",
      "tags": null,
      "key_image_url": "\"https://trove.tools/TroveSquare.png\"",
      "all_metadata": "{ \"description\" : \"\\\"Your Swap Proposal on trove.tools\\\"\", \"icon_url\" : \"\\\"https://trove.tools/TroveSquare.png\\\"\", \"key_image_url\" : \"\\\"https://trove.tools/TroveSquare.png\\\"\", \"name\" : \"\\\"TROVE Key: rippy for you\\\"\" }"
    },
    {
      "id": 878314,
      "address": "resource_rdx1n2r0ev0xklcf3cz08ma3xrt2at6r8twss5qjlpnp2adcxk608ukjw7",
      "non_fungible_id_type": "string",
      "created_at": "2023-10-29T14:33:19.996Z",
      "supply_changed_at": 11584528,
      "total_minted": "2000000000000000000",
      "total_burned": "2000000000000000000",
      "total_supply": "0",
      "name": "\"TROVE Key: New fees, who dis\"",
      "description": "\"Your Swap Proposal on trove.tools\"",
      "icon_url": "\"https://trove.tools/TroveSquare.png\"",
      "tags": null,
      "key_image_url": "\"https://trove.tools/TroveSquare.png\"",
      "all_metadata": "{ \"description\" : \"\\\"Your Swap Proposal on trove.tools\\\"\", \"icon_url\" : \"\\\"https://trove.tools/TroveSquare.png\\\"\", \"key_image_url\" : \"\\\"https://trove.tools/TroveSquare.png\\\"\", \"name\" : \"\\\"TROVE Key: New fees, who dis\\\"\" }"
    }
  ],
  "pagination": {...}
}

Resource Holders

POST /v1/resource-holders

Fetch the resource holdings for entity on the Radix Network.

Parameters

  • holder_addresses (optional list of strings)

    • Addresses to filter by

  • holder_ids (optional List of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "holder_addresses": [
    "account_rdx169yzkrr5p93e3hgx4t2p4ngh2tt0ldscrtjve4yyt902a7whhzrfu9"
  ],
  "holder_ids": [ 16 ]
}
Example Response
{
  "data": [
    {
      "holder_id": 16,
      "resource_id": 20,
      "holder_address": "consensusmanager_rdx1scxxxxxxxxxxcnsmgrxxxxxxxxx000999665565xxxxxxxxxcnsmgr",
      "holder_discriminator": "GlobalConsensusManager",
      "resource_address": "resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd",
      "resource_discriminator": "GlobalFungibleResource",
      "balance": "1347201835",
      "last_changed_at": "2023-12-10T15:05:57.468Z"
    },
    {
      "holder_id": 42,
      "resource_id": 20,
      "holder_address": "account_rdx169yzkrr5p93e3hgx4t2p4ngh2tt0ldscrtjve4yyt902a7whhzrfu9",
      "holder_discriminator": "GlobalAccountComponent",
      "resource_address": "resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd",
      "resource_discriminator": "GlobalFungibleResource",
      "balance": "52824048194469267600",
      "last_changed_at": "2023-12-07T20:38:08.128Z"
    },
    {
      "holder_id": 42,
      "resource_id": 29,
      "holder_address": "account_rdx169yzkrr5p93e3hgx4t2p4ngh2tt0ldscrtjve4yyt902a7whhzrfu9",
      "holder_discriminator": "GlobalAccountComponent",
      "resource_address": "resource_rdx1nfxxxxxxxxxxvdrwnrxxxxxxxxx004365253834xxxxxxxxxvdrwnr",
      "resource_discriminator": "GlobalNonFungibleResource",
      "balance": "1000000000000000000",
      "last_changed_at": "2023-09-28T06:33:34.721Z"
    },
    ...
  ],
  "pagination": {...}
}

Resource Holders

POST /v1/role-assignments

Fetch role assignment for entities on the Radix Network.

Parameters

  • holder_ids (optional List of integers)

    • Entity ID's to filter by

Example Request
{
  "entity_ids": [ 20 ]
}
Example Response
{
  "data": [
    {
      "id": 20,
      "key_role": "burner",
      "key_module": "main",
      "role_assignments": "{\"type\": \"Protected\", \"access_rule\": {\"type\": \"ProofRule\", \"proof_rule\": {\"type\": \"Require\", \"requirement\": {\"type\": \"NonFungible\", \"non_fungible\": {\"local_id\": {\"id_type\": \"Bytes\", \"sbor_hex\": \"5cc0022068c44e9d432e71c51e2a2ac285897b372328d8b31374ff29131bc6b25b6bd070\", \"simple_rep\": \"[68c44e9d432e71c51e2a2ac285897b372328d8b31374ff29131bc6b25b6bd070]\"}, \"resource_address\": \"resource_rdx1nfxxxxxxxxxxglcllrxxxxxxxxx002350006550xxxxxxxxxglcllr\"}}}}}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "burner_updater",
      "key_module": "main",
      "role_assignments": "{\"type\": \"DenyAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "depositor",
      "key_module": "main",
      "role_assignments": "{\"type\": \"AllowAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "depositor_updater",
      "key_module": "main",
      "role_assignments": "{\"type\": \"DenyAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "freezer",
      "key_module": "main",
      "role_assignments": "{\"type\": \"DenyAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "freezer_updater",
      "key_module": "main",
      "role_assignments": "{\"type\": \"DenyAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "minter",
      "key_module": "main",
      "role_assignments": "{\"type\": \"Protected\", \"access_rule\": {\"type\": \"ProofRule\", \"proof_rule\": {\"type\": \"Require\", \"requirement\": {\"type\": \"NonFungible\", \"non_fungible\": {\"local_id\": {\"id_type\": \"Bytes\", \"sbor_hex\": \"5cc0022068c44e9d432e71c51e2a2ac285897b372328d8b31374ff29131bc6b25b6bd070\", \"simple_rep\": \"[68c44e9d432e71c51e2a2ac285897b372328d8b31374ff29131bc6b25b6bd070]\"}, \"resource_address\": \"resource_rdx1nfxxxxxxxxxxglcllrxxxxxxxxx002350006550xxxxxxxxxglcllr\"}}}}}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "minter_updater",
      "key_module": "main",
      "role_assignments": "{\"type\": \"DenyAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "recaller",
      "key_module": "main",
      "role_assignments": "{\"type\": \"DenyAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "recaller_updater",
      "key_module": "main",
      "role_assignments": "{\"type\": \"DenyAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "withdrawer",
      "key_module": "main",
      "role_assignments": "{\"type\": \"AllowAll\"}",
      "from_state_version": 2
    },
    {
      "id": 20,
      "key_role": "withdrawer_updater",
      "key_module": "main",
      "role_assignments": "{\"type\": \"DenyAll\"}",
      "from_state_version": 2
    }
  ],
  "pagination": {...}
}

Token Balances

POST /v1/token-balances

Fetch token-only holdings for entity on the Radix Network.

Parameters

  • holder_addresses (optional list of strings)

    • Addresses to filter by

  • holder_ids (optional List of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "holder_addresses": [
    "validator_rdx1svsvx7w30pq4d2t3587r5tqkv7gne7pgdrtgtl94uefax07qr50quu"
  ],
  "holder_ids": [ 1856 ]
}
Example Response
{
  "data": [
    {
      "holder_id": 1856,
      "holder_address": "validator_rdx1s0fsq205yuxukmpdrcaxqueq3phzknpvwahkskjvz69atk2c08f07d",
      "balance": "50573223376546305902379302",
      "last_changed_at": "2023-12-10T15:05:57.468Z",
      "holder_discriminator": "global_validator",
      "resource_id": 20,
      "resource_address": "resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd",
      "name": "\"Radix\"",
      "tags": null,
      "symbol": "\"XRD\"",
      "icon_url": "\"https://assets.radixdlt.com/icons/icon-xrd-32x32.png\"",
      "info_url": "\"https://tokens.radixdlt.com\"",
      "description": "\"The Radix Public Network's native token, used to pay the network's required transaction fees and to secure the network through staking to its validator nodes.\""
    },
    {
      "holder_id": 1856,
      "holder_address": "validator_rdx1s0fsq205yuxukmpdrcaxqueq3phzknpvwahkskjvz69atk2c08f07d",
      "balance": "82170107769425117571089",
      "last_changed_at": "2023-12-10T15:05:57.468Z",
      "holder_discriminator": "global_validator",
      "resource_id": 1938,
      "resource_address": "resource_rdx1tkvg0lfhfet2cmm5hu55anjfwsq2qh8lkllmkh3dzpu4f842mmgnzc",
      "name": "\"Liquid Stake Units\"",
      "tags": null,
      "symbol": null,
      "icon_url": "\"https://assets.radixdlt.com/icons/icon-liquid_stake_units.png\"",
      "info_url": null,
      "description": "\"Liquid Stake Unit tokens that represent a proportion of XRD stake delegated to a Radix Network validator.\""
    },
    {
      "holder_id": 1859,
      "holder_address": "validator_rdx1svsvx7w30pq4d2t3587r5tqkv7gne7pgdrtgtl94uefax07qr50quu",
      "balance": "7925015973394707056030360",
      "last_changed_at": "2023-12-10T15:05:57.468Z",
      "holder_discriminator": "global_validator",
      "resource_id": 20,
      "resource_address": "resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd",
      "name": "\"Radix\"",
      "tags": null,
      "symbol": "\"XRD\"",
      "icon_url": "\"https://assets.radixdlt.com/icons/icon-xrd-32x32.png\"",
      "info_url": "\"https://tokens.radixdlt.com\"",
      "description": "\"The Radix Public Network's native token, used to pay the network's required transaction fees and to secure the network through staking to its validator nodes.\""
    },
    {
      "holder_id": 1859,
      "holder_address": "validator_rdx1svsvx7w30pq4d2t3587r5tqkv7gne7pgdrtgtl94uefax07qr50quu",
      "balance": "2239110421909976931588",
      "last_changed_at": "2023-12-10T15:05:57.468Z",
      "holder_discriminator": "global_validator",
      "resource_id": 1944,
      "resource_address": "resource_rdx1thudk8yaj9jqysg3j4anyll3zhpe8cvukfz6qsnqr8tdfjh0f9acgf",
      "name": "\"Liquid Stake Units\"",
      "tags": null,
      "symbol": null,
      "icon_url": "\"https://assets.radixdlt.com/icons/icon-liquid_stake_units.png\"",
      "info_url": null,
      "description": "\"Liquid Stake Unit tokens that represent a proportion of XRD stake delegated to a Radix Network validator.\""
    }
  ],
  "pagination": {...}
}

Validators

POST /v1/validators

Fetch validators on the Radix Network.

Parameters

  • addresses (optional list of strings)

    • Addresses to filter by

  • entity_ids (optional List of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "addresses": [
    "validator_rdx1s0g5uuw3a7ad7akueetzq5lpejzp9uw5glv2qnflvymgendvepgduj"
  ],
  "entity_ids": [ 1854 ]
}
Example Response
{
  "data": [
    {
      "id": 1079,
      "address": "validator_rdx1s0g5uuw3a7ad7akueetzq5lpejzp9uw5glv2qnflvymgendvepgduj",
      "name": "\"🥇 XIDAR\"",
      "info_url": "\"https://xidar.io\"",
      "icon_url": "\"https://xidar.io/assets/IDA.png\"",
      "description": "\"XIDAR empowers everyone with advanced yet simple products, enabling  easy and safe exploration and navigation of  the future digital landscape .\"",
      "is_registered": true,
      "stake_xrd_vault_address": "internal_vault_rdx1tpkyry4s7rlwjzqddf65d384uph00587wu7t3rgc9mg8djdrgmmuad",
      "validator_fee_factor": "1",
      "accepts_delegated_stake": true,
      "pending_xrd_withdraw_vault_address": "internal_vault_rdx1tqw39jmz8xyykev68k7ml33tpq5dcfmngrjng8rlwtsgagpcsq0cuq",
      "stake_unit_resource_address": "resource_rdx1tkfxrsffdlh82fjxjwpgrgrgcmc7cfe0sy99c7vm6gsnujelupglnj",
      "claim_token_resource_address": "resource_rdx1nt7uscrcl2dxtugxzl5wws92fwm2rl2g7e4v66ane49kkn7xdmpftz",
      "validator_fee_change_request": null,
      "locked_owner_stake_unit_vault_address": "internal_vault_rdx1trzqhpxc433564hhn79vle85cp6493ahek5lvp64z3g3ttvjxuff8u",
      "pending_owner_stake_unit_withdrawals": null,
      "pending_owner_stake_unit_unlock_vault_address": "internal_vault_rdx1tp3ay9pfsvf2amefru25hshhzzj2g74slnzragy89m0d99apjc2hhq",
      "already_unlocked_owner_stake_unit_amount": 0
    },
    {
      "id": 1854,
      "address": "validator_rdx1s0eg9fzf0wm9yucpzug69fyngjpdw6w7ra50j74ktvahhhysmxyw68",
      "name": "\"🔥 EasyStake (🇸🇬 SG)\"",
      "info_url": "\"https://www.easystake.net\"",
      "icon_url": null,
      "description": null,
      "is_registered": true,
      "stake_xrd_vault_address": "internal_vault_rdx1tpujf8fk7jzcjwlg03u7raucwr0vppup4f5pgxed7y7r0p4qk4kuw0",
      "validator_fee_factor": "2",
      "accepts_delegated_stake": true,
      "pending_xrd_withdraw_vault_address": "internal_vault_rdx1tqw5alptvmg36q3m8e3dk3xjdm2sjf4fnwjvf0z2peaz2e0re63ut0",
      "stake_unit_resource_address": "resource_rdx1thwyxe5luuxaf30a26qrltt6wmpytqstslq7zeccvm50y2x67jetvq",
      "claim_token_resource_address": "resource_rdx1ntde3ahw897alz386kww80smvkaedyhq6q2k8cg0jeaul74gz7n0rl",
      "validator_fee_change_request": null,
      "locked_owner_stake_unit_vault_address": "internal_vault_rdx1traj3psnej5q8lkf754xmtts6q0kak7hj9sa5x94w5kctvys5nt466",
      "pending_owner_stake_unit_withdrawals": null,
      "pending_owner_stake_unit_unlock_vault_address": "internal_vault_rdx1tpg96399s5gfddtj8mrqwv0ddk3fhn50xp36z4xjawdt4zu9acwtvf",
      "already_unlocked_owner_stake_unit_amount": 0
    }
  ],
  "pagination": {...}
}

Vaults

POST /v1/vaults

Fetch vaults on the Radix Network.

Parameters

  • addresses (optional list of strings)

    • Addresses to filter by

  • entity_ids (optional List of integers)

    • Entity ID's to filter by

If both parameters are provided then it will return accounts with specified address OR entity identifier.

Example Request
{
  "addresses": [
    "internal_vault_rdx1tzxq7kksudewyknphdfgsjxgphcaml7ddscvng5z6han0l66tp54mx"
  ],
  "entity_ids": [ 536 ]
}
Example Response
{
  "data": [
    {
      "id": 529,
      "address": "internal_vault_rdx1tzxq7kksudewyknphdfgsjxgphcaml7ddscvng5z6han0l66tp54mx",
      "owner_id": "133",
      "resource_id": "20",
      "balance": "0",
      "vault_type": "InternalFungibleVault",
      "is_royalty_vault": false,
      "created_at": "2023-09-28T06:33:34.721Z",
      "updated_at": "2023-09-28T06:33:34.721Z"
    },
    {
      "id": 536,
      "address": "internal_vault_rdx1tpghh76lnmyscu7p9qusfe24ugm2ps9sqs8e28m35sgd4462699ckv",
      "owner_id": "135",
      "resource_id": "20",
      "balance": "3000024793198625783950770",
      "vault_type": "InternalFungibleVault",
      "is_royalty_vault": false,
      "created_at": "2023-09-28T06:33:34.721Z",
      "updated_at": "2023-12-10T15:05:57.468Z"
    }
  ],
  "pagination": {...}
}

here