MinaSearch
  • Getting Started
    • Overview
    • Data Exploration
  • APIs
    • GraphQL
    • REST
    • HTTP
  • Terminology
    • Definitions
    • Glossary
  • Legal
    • Terms of Service
    • Disclaimer
Powered by GitBook
On this page
  1. APIs

REST

PreviousGraphQLNextHTTP

Last updated 1 month ago

The REST API provides full data for a few objects (Accounts and Blocks). However, it is limited in the objects it supports and in its search capacity. For acess to all objects and full search capicity, use the .

GET https://api.minasearch.com/summary
{
  "blockchainLength": 359604,
  "chainId": "5f704cc0c82e0ed70e873f0893d7e06f148524e3f0bdae2afb02e7819a0c24d1",
  "circulatingSupply": "1115666601.840039233",
  "dateTime": "Tue, 04 Jun 2024 08:51:00 GMT",
  "epoch": 79,
  "slot": 117,
  "globalSlot": 564177,
  "lockedSupply": "50382211",
  "minWindowDensity": 13,
  "nextEpochLedgerHash": "jxxi9eTEPUFzS6eFsdigEEnhYWsKZhCR6GVJrbgcxHJYZgG4vs4",
  "previousStateHash": "3NKP33D4UBnbj3jaYvm887AVAoaLDwMqvW54TRyUCS1y9S8cSzcb",
  "snarkedLedgerHash": "jwuHpCmJ2wGXCNohYFdFwPTnzogYzJ4ACh9kRfzgosA5yYMEu4Q",
  "stagedLedgerHash": "jxzsDCwThbSpdSN1SiqpoiSex6o9gncVJ57N67qSe6xB67kVSrE",
  "stakingEpochLedgerHash": "jxxZUYeVFQriATHvBCrxmtfwtboFtMbXALVkE4y546MPy597QDD",
  "stateHash": "3NLRTfY4kZyJtvaP4dFenDcxfoMfT3uEpkWS913KkeXLtziyVd15",
  "totalCurrency": "1166048812.840039233",
  "totalNumAccounts": 226491,
  "epochNumBlocks": 155,
  "totalNumBlocks": 873913,
  "epochNumSnarks": 1447,
  "totalNumSnarks": 8858057,
  "totalNumCanonicalSnarks": 7384314,
  "epochNumUserCommands": 2480,
  "totalNumUserCommands": 18183978,
  "totalNumAppliedUserCommands": 18179594,
  "totalNumFailedUserCommands": 4384,
  "totalNumCanonicalUserCommands": 6270243,
  "totalNumAppliedCanonicalUserCommands": 6268794,
  "totalNumFailedCanonicalUserCommands": 1449,
  "epochNumInternalCommands": 157,
  "totalNumInternalCommands": 4002547,
  "totalNumCanonicalInternalCommands": 1446280,
  "dbVersion": "0.12.16-3a980fd4",
  "indexerVersion": "0.1.1-9c74d193"
}

By Public Key

GET https://api.minasearch.com/accounts/B62qiUYSjLkQuvgouQ1HarLdtBLvwtoueTZvRWP3hm7UDjvryWJydb8
{
  "public_key": "B62qiUYSjLkQuvgouQ1HarLdtBLvwtoueTZvRWP3hm7UDjvryWJydb8",
  "balance": 285897213905759,
  "nonce": 2763,
  "delegate": "B62qq3TQ8AP7MFYPVtMx5tZGF3kWLJukfwG1A1RGvaBW1jfTPTkDBW6",
  "genesis_account": false,
  "token": null,
  "token_permissions": null,
  "receipt_chain_hash": null,
  "voting_for": null,
  "permissions": null,
  "timing": null,
  "zkapp": null,
  "username": null,
  "epoch_num_blocks": 0,
  "total_num_blocks": 0,
  "epoch_num_snarks": 0,
  "total_num_snarks": 0,
  "epoch_num_user_commands": 0,
  "total_num_user_commands": 8118,
  "epoch_num_internal_commands": 0,
  "total_num_internal_commands": 7273
}

By State Hash

GET https://api.minasearch.com/blocks/3NKRgfyBf4oHZKZRuqN6FkCJdZ7RbgjESFsR8c4aKjnjFRsDvjCK

{
  "canonical": true,
  "epoch_num_blocks": 166,
  "epoch_num_canonical_blocks": 100,
  "epoch_num_supercharged_blocks": 20,
  "total_num_blocks": 166,
  "total_num_canonical_blocks": 100,
  "total_num_supercharged_blocks": 20,
  "block_num_snarks": 0,
  "block_num_user_commands": 3,
  "block_num_internal_commands": 2,
  "epoch_num_slots_produced": 100,
  "num_unique_block_producers_last_n_blocks": null,
  "block": {
    "state_hash": "3NKGnZMYQiKAZDZfAnyHgVPhSrMWRHaR3aHMnAc28oatHJiifVFz",
    "block_height": 95,
    "global_slot_since_genesis": 136,
    "winner_account": {
      "public_key": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC"
    },
    "date_time": "2021-03-17T06:48:00.000Z",
    "received_time": "2021-03-17T06:48:34.898Z",
    "creator_account": {
      "public_key": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC"
    },
    "coinbase_receiver": {
      "public_key": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC"
    },
    "creator": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC",
    "protocol_state": {
      "previous_state_hash": "3NK7n6j2Bx9yCVjv2AKnfxwvwvCL9uww9mQaefkm3zyabdrcczjA",
      "blockchain_state": {
        "utc_date": "1615963680000",
        "date": "1615963680000",
        "snarked_ledger_hash": "jx7buQVWFLsXTtzRgSxbYcT8EYLS8KCZbLrfDcJxMtyy4thw2Ee",
        "staged_ledger_hash": "jx1mMFf433UeHdb6c4pPHcMvyRGsdmzEaYh7p66m49Cz7RJmPXR"
      },
      "consensus_state": {
        "total_currency": 805385692840039233,
        "blockchain_length": 95,
        "block_height": 95,
        "epoch_count": 0,
        "epoch": 0,
        "has_ancestor_in_same_checkpoint_window": true,
        "last_vrf_output": "lR1013dg7Yms68xJLBArsQcYdPbZdE6ldbJBmNd4DgA=",
        "min_window_density": 77,
        "slot": 136,
        "slot_since_genesis": 136,
        "next_epoch_data": {
          "seed": "2vb3d6UdrpXTrLxjxjbwHPZJLpJzQZNBYV2xrZYJRWJs3KaX7LGY",
          "epoch_length": 96,
          "start_checkpoint": "3NK2tkzqqK5spR2sZ7tujjqPksL45M3UUrcA4WhCkeiPtnugyE2x",
          "lock_checkpoint": "3NK7n6j2Bx9yCVjv2AKnfxwvwvCL9uww9mQaefkm3zyabdrcczjA",
          "ledger": {
            "hash": "jx7buQVWFLsXTtzRgSxbYcT8EYLS8KCZbLrfDcJxMtyy4thw2Ee",
            "total_currency": 805385692840039233
          }
        },
        "staking_epoch_data": {
          "seed": "2va9BGv9JrLTtrzZttiEMDYw1Zj6a6EHzXjmP9evHDTG3oEquURA",
          "epoch_length": 96,
          "start_checkpoint": "3NK2tkzqqK5spR2sZ7tujjqPksL45M3UUrcA4WhCkeiPtnugyE2x",
          "lock_checkpoint": "3NK2tkzqqK5spR2sZ7tujjqPksL45M3UUrcA4WhCkeiPtnugyE2x",
          "ledger": {
            "hash": "jx7buQVWFLsXTtzRgSxbYcT8EYLS8KCZbLrfDcJxMtyy4thw2Ee",
            "total_currency": 805385692840039233
          }
        }
      }
    },
    "tx_fees": "30000000",
    "snark_fees": "0",
    "transactions": {
      "coinbase": "720000000000",
      "coinbase_receiver_account": {
        "public_key": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC"
      },
      "fee_transfer": [
        {
          "fee": "30000000",
          "recipient": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC",
          "feetransfer_kind": "Fee_transfer"
        }
      ],
      "user_commands": [
        {
          "amount": 1000,
          "block_height": 95,
          "global_slot": 136,
          "canonical": true,
          "failure_reason": null,
          "is_applied": true,
          "fee": 10000000,
          "from": "B62qre3erTHfzQckNuibViWQGyyKwZseztqrjPZBv6SQF384Rg6ESAy",
          "hash": "CkpZzZtaDCDsXCF23bUcytwKxEMM5i9xcKMRTVSUzqjjo2ZM3mqwq",
          "kind": "PAYMENT",
          "memo": "",
          "nonce": 138,
          "receiver": {
            "public_key": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM"
          },
          "to": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM",
          "token": 1,
          "epoch_num_user_commands": 247,
          "total_num_user_commands": 247
        },
        {
          "amount": 1000,
          "block_height": 95,
          "global_slot": 136,
          "canonical": true,
          "failure_reason": null,
          "is_applied": true,
          "fee": 10000000,
          "from": "B62qre3erTHfzQckNuibViWQGyyKwZseztqrjPZBv6SQF384Rg6ESAy",
          "hash": "CkpZDke3de25Peph3L7WShQqXF9hfoZ4bwUq1n3SHiWSENF2f539v",
          "kind": "PAYMENT",
          "memo": "",
          "nonce": 139,
          "receiver": {
            "public_key": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM"
          },
          "to": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM",
          "token": 1,
          "epoch_num_user_commands": 247,
          "total_num_user_commands": 247
        },
        {
          "amount": 1000,
          "block_height": 95,
          "global_slot": 136,
          "canonical": true,
          "failure_reason": null,
          "is_applied": true,
          "fee": 10000000,
          "from": "B62qre3erTHfzQckNuibViWQGyyKwZseztqrjPZBv6SQF384Rg6ESAy",
          "hash": "CkpYTBgcbGKGfpKdVEu8L8xfr646VBtYbiYJLjkHwEvPJKKNWPdTe",
          "kind": "PAYMENT",
          "memo": "",
          "nonce": 140,
          "receiver": {
            "public_key": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM"
          },
          "to": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM",
          "token": 1,
          "epoch_num_user_commands": 247,
          "total_num_user_commands": 247
        }
      ]
    },
    "snark_jobs": []
  }
}

By Height

Default limit: 10

GET https://api.minasearch.com/blocks?height=359604?limit=1
[
    {
      "canonical": true,
      "epoch_num_blocks": 166,
      "epoch_num_canonical_blocks": 100,
      "epoch_num_supercharged_blocks": 20,
      "total_num_blocks": 166,
      "total_num_canonical_blocks": 100,
      "total_num_supercharged_blocks": 20,
      "block_num_snarks": 0,
      "block_num_user_commands": 3,
      "block_num_internal_commands": 2,
      "epoch_num_slots_produced": 100,
      "num_unique_block_producers_last_n_blocks": null,
      "block": {
        "state_hash": "3NKGnZMYQiKAZDZfAnyHgVPhSrMWRHaR3aHMnAc28oatHJiifVFz",
        "block_height": 95,
        "global_slot_since_genesis": 136,
        "winner_account": {
          "public_key": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC"
        },
        "date_time": "2021-03-17T06:48:00.000Z",
        "received_time": "2021-03-17T06:48:34.898Z",
        "creator_account": {
          "public_key": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC"
        },
        "coinbase_receiver": {
          "public_key": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC"
        },
        "creator": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC",
        "protocol_state": {
          "previous_state_hash": "3NK7n6j2Bx9yCVjv2AKnfxwvwvCL9uww9mQaefkm3zyabdrcczjA",
          "blockchain_state": {
            "utc_date": "1615963680000",
            "date": "1615963680000",
            "snarked_ledger_hash": "jx7buQVWFLsXTtzRgSxbYcT8EYLS8KCZbLrfDcJxMtyy4thw2Ee",
            "staged_ledger_hash": "jx1mMFf433UeHdb6c4pPHcMvyRGsdmzEaYh7p66m49Cz7RJmPXR"
          },
          "consensus_state": {
            "total_currency": 805385692840039233,
            "blockchain_length": 95,
            "block_height": 95,
            "epoch_count": 0,
            "epoch": 0,
            "has_ancestor_in_same_checkpoint_window": true,
            "last_vrf_output": "lR1013dg7Yms68xJLBArsQcYdPbZdE6ldbJBmNd4DgA=",
            "min_window_density": 77,
            "slot": 136,
            "slot_since_genesis": 136,
            "next_epoch_data": {
              "seed": "2vb3d6UdrpXTrLxjxjbwHPZJLpJzQZNBYV2xrZYJRWJs3KaX7LGY",
              "epoch_length": 96,
              "start_checkpoint": "3NK2tkzqqK5spR2sZ7tujjqPksL45M3UUrcA4WhCkeiPtnugyE2x",
              "lock_checkpoint": "3NK7n6j2Bx9yCVjv2AKnfxwvwvCL9uww9mQaefkm3zyabdrcczjA",
              "ledger": {
                "hash": "jx7buQVWFLsXTtzRgSxbYcT8EYLS8KCZbLrfDcJxMtyy4thw2Ee",
                "total_currency": 805385692840039233
              }
            },
            "staking_epoch_data": {
              "seed": "2va9BGv9JrLTtrzZttiEMDYw1Zj6a6EHzXjmP9evHDTG3oEquURA",
              "epoch_length": 96,
              "start_checkpoint": "3NK2tkzqqK5spR2sZ7tujjqPksL45M3UUrcA4WhCkeiPtnugyE2x",
              "lock_checkpoint": "3NK2tkzqqK5spR2sZ7tujjqPksL45M3UUrcA4WhCkeiPtnugyE2x",
              "ledger": {
                "hash": "jx7buQVWFLsXTtzRgSxbYcT8EYLS8KCZbLrfDcJxMtyy4thw2Ee",
                "total_currency": 805385692840039233
              }
            }
          }
        },
        "tx_fees": "30000000",
        "snark_fees": "0",
        "transactions": {
          "coinbase": "720000000000",
          "coinbase_receiver_account": {
            "public_key": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC"
          },
          "fee_transfer": [
            {
              "fee": "30000000",
              "recipient": "B62qrafvvcSTkGMpFiprxzDN8JXqoiyHSUQwUsKbRqrvTK1khb1HJyC",
              "feetransfer_kind": "Fee_transfer"
            }
          ],
          "user_commands": [
            {
              "amount": 1000,
              "block_height": 95,
              "global_slot": 136,
              "canonical": true,
              "failure_reason": null,
              "is_applied": true,
              "fee": 10000000,
              "from": "B62qre3erTHfzQckNuibViWQGyyKwZseztqrjPZBv6SQF384Rg6ESAy",
              "hash": "CkpZzZtaDCDsXCF23bUcytwKxEMM5i9xcKMRTVSUzqjjo2ZM3mqwq",
              "kind": "PAYMENT",
              "memo": "",
              "nonce": 138,
              "receiver": {
                "public_key": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM"
              },
              "to": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM",
              "token": 1,
              "epoch_num_user_commands": 247,
              "total_num_user_commands": 247
            },
            {
              "amount": 1000,
              "block_height": 95,
              "global_slot": 136,
              "canonical": true,
              "failure_reason": null,
              "is_applied": true,
              "fee": 10000000,
              "from": "B62qre3erTHfzQckNuibViWQGyyKwZseztqrjPZBv6SQF384Rg6ESAy",
              "hash": "CkpZDke3de25Peph3L7WShQqXF9hfoZ4bwUq1n3SHiWSENF2f539v",
              "kind": "PAYMENT",
              "memo": "",
              "nonce": 139,
              "receiver": {
                "public_key": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM"
              },
              "to": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM",
              "token": 1,
              "epoch_num_user_commands": 247,
              "total_num_user_commands": 247
            },
            {
              "amount": 1000,
              "block_height": 95,
              "global_slot": 136,
              "canonical": true,
              "failure_reason": null,
              "is_applied": true,
              "fee": 10000000,
              "from": "B62qre3erTHfzQckNuibViWQGyyKwZseztqrjPZBv6SQF384Rg6ESAy",
              "hash": "CkpYTBgcbGKGfpKdVEu8L8xfr646VBtYbiYJLjkHwEvPJKKNWPdTe",
              "kind": "PAYMENT",
              "memo": "",
              "nonce": 140,
              "receiver": {
                "public_key": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM"
              },
              "to": "B62qjYanmV7y9njVeH5UHkz3GYBm7xKir1rAnoY4KsEYUGLMiU45FSM",
              "token": 1,
              "epoch_num_user_commands": 247,
              "total_num_user_commands": 247
            }
          ]
        },
        "snark_jobs": []
      }
    }
]

You can retrieve any block's raw JSON using these .

GraphQL API
instructions