{ "openapi": "3.0.3", "info": { "title": "AdaStat Cardano REST API", "version": "1.0.0", "description": "# Introduction\nAccess [AdaStat.net](https://adastat.net/) data such as epochs, blocks, transactions, pools, accounts, addresses, tokens and more\n\nUse our free and fast API to power your applications\n\nWe would appreciate any link or mention of Powered by AdaStat API in your awesome application\n# API Specification\nThis API is documented in **OpenAPI format**\n\nAll our data is provided under [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0.html) for free and AS IS with no warranty\n\nTimestamps returned by this API are in UTC Timezone\n\nADA amounts returned by this API are in lovelace\n\nPercentage values are returned as a floating point number from 0 to 1\n# Cross-Origin Resource Sharing\nThis API does not support Cross-Origin Resource Sharing (CORS) and does not allow cross-domain communication from the browser\n# Authentication\nThis API does not require authentication\n# Pagination\nThis API uses cursor-based pagination and separates results into pages, the size of which are defined by the `limit` request parameter. In case the next page is available the API response contains the `cursor` object with 2 keys - key `after` that is the cursor value, and key `next` that is equal `true` in case the next page exists, otherwise `false`. To get the next page you need to repeat the previous request with the same parameters, but adding the `after` parameter from the `cursor` object to the query string. The maximum number of items per page (limit) is 1000, the default value is 10\n# Rate Limit\nAvoid sending more than one request per second. We may allow short bursts that go over this limit, but eventually you'll begin receiving 429 errors", "x-logo": { "url": "https://api.adastat.net/logo.png", "altText": "AdaStat Logo" }, "contact": { "name": "API Support", "email": "api@adastat.net" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" } }, "servers": [{ "url": "https://api.adastat.net/rest/v1", "description": "Cardano Mainnet" } ], "tags": [{ "name": "api_general", "x-displayName": "General", "description": "AdaStat API server info" }, { "name": "cardano_general", "x-displayName": "General", "description": "Information about Cardano" }, { "name": "cardano_epochs", "x-displayName": "Epochs", "description": "Information about epochs" }, { "name": "cardano_blocks", "x-displayName": "Blocks", "description": "Information about blocks" }, { "name": "cardano_txs", "x-displayName": "Transactions", "description": "Information about transactions" }, { "name": "cardano_pools", "x-displayName": "Pools", "description": "Information about pools" }, { "name": "cardano_accounts", "x-displayName": "Accounts", "description": "Information about accounts" }, { "name": "cardano_addresses", "x-displayName": "Addresses", "description": "Information about addresses" }, { "name": "cardano_tokens", "x-displayName": "Tokens", "description": "Information about tokens" } ], "x-tagGroups": [{ "name": "API Server", "tags": [ "api_general" ] }, { "name": "Cardano Blockchain", "tags": [ "cardano_general", "cardano_epochs", "cardano_blocks", "cardano_txs", "cardano_pools", "cardano_accounts", "cardano_addresses", "cardano_tokens" ] } ], "paths": { "/status.json": { "get": { "tags": [ "api_general" ], "summary": "Check API server status", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "message": { "description": "API server status", "type": "string", "example": "AdaStat API Server is live" }, "api_version": { "description": "API version", "type": "string", "example": "1.0.0" } }, "required": [ "code", "message", "api_version" ] } } } }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/summary.json": { "get": { "tags": [ "cardano_general" ], "summary": "Get Cardano summary", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data" : { "description": "Summary data", "type": "object", "example": { "tx": 55547945, "tx_out_sum": "19191043916833531578", "tx_fee": "16157189149077", "tx_amount": "11270844154100656314", "max_tx": 1566974, "max_tx_epoch": 304, "min_tx": 33, "min_tx_epoch": 0, "avg_tx": 146720, "live_load": 0.34, "live_tps": 1.45, "block_height": 8068194, "max_block": 21702, "max_block_epoch": 267, "min_block": 19345, "min_block_epoch": 347, "avg_block": 21335, "max_block_size": 148187, "min_block_size": 3, "sum_block_size": 89520865546, "block": 8068371, "block_with_tx": 4827944, "account": 3742720, "account_with_amount": 2085073, "delegator": 1234482, "delegator_with_stake": 1208945, "shelley_amount": "31857556853607089", "stake": "25049623394653210", "reward_amount": "2323007435660058", "byron": 11191621, "byron_with_amount": 321744, "byron_amount": "2576361232227709", "pool": 3231, "pool_with_stake": 2974, "pool_with_block": 2812, "pool_retired": 2167, "rewarded_account": 1410844, "pool_fee": "400752312108937", "saturation_point": "70387610212989", "epoch_no": 378, "epoch_slot_no": 80216, "slot_no": 78013016 } } }, "required": [ "code", "blocks", "txs", "txs_amount", "txs_output", "txs_fee", "register_pools", "retire_pools", "stake_pools", "accounts", "delegators", "shelley_addresses", "byron_addresses", "shelley_amount", "byron_amount", "stake_amount", "rewards_amount", "tokens" ] } } } }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/epochs.json": { "get": { "tags": [ "cardano_epochs" ], "summary": "Get epochs data", "description": "Returns summary epochs data and data by each epoch", "parameters": [{ "name": "rows", "in": "query", "description": "Include or not rows", "schema": { "type": "string", "enum": [ "true", "false" ], "default": false } }, { "name": "sort", "in": "query", "description": "Sort epochs by field", "schema": { "type": "string", "enum": [ "no", "tx_amount", "circulating_supply", "pool", "pool_with_block", "pool_with_stake", "pool_fee", "reward_amount", "stake", "delegator", "account", "account_with_reward", "pool_register", "pool_retire", "orphaned_reward_amount", "block_with_tx", "byron", "byron_with_amount", "byron_amount", "account_with_amount", "delegator_with_stake", "token", "token_policy", "token_holder", "token_tx", "out_sum", "fees", "tx", "block" ], "default": "no" } }, { "$ref": "#/components/parameters/DirParam" }, { "$ref": "#/components/parameters/LimitParam" }, { "$ref": "#/components/parameters/CursorParam" }, { "$ref": "#/components/parameters/CurrencyParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "description": "Summary data", "type": "object", "example": { "epoch_no": 377, "epoch_slot_no": 74387, "slot_no": 77575187 } }, "rows": { "description": "Epochs list", "type": "array", "items": { "$ref": "#/components/schemas/Epoch" } }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/epochs/{epoch_number}.json": { "get": { "tags": [ "cardano_epochs" ], "summary": "Get epoch", "description": "Returns data by epoch", "parameters": [{ "name": "epoch_number", "in": "path", "description": "Number of the epoch", "required": true, "schema": { "type": "integer", "minimum": 0 }, "example": 375 } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "allOf": [ { "$ref": "#/components/schemas/Epoch" }, { "type": "object", "properties": { "current_epoch_no": { "description": "Current epoch number", "type": "integer", "format": "int32", "example": 377 }, "current_epoch_slot_no": { "description": "Current epoch slot number", "type": "integer", "format": "int32", "example": 170134 }, "current_slot_no": { "description": "Current slot number", "type": "integer", "format": "int32", "example": 77670934 } } } ] } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/blocks.json": { "get": { "tags": [ "cardano_blocks" ], "summary": "Get blocks list", "description": "Returns data by each block", "parameters": [{ "name": "rows", "in": "query", "description": "Include or not rows", "schema": { "type": "string", "enum": [ "true", "false" ], "default": false } }, { "name": "sort", "in": "query", "description": "Sort blocks by field", "schema": { "type": "string", "enum": [ "no", "tx_amount", "tx_out_sum", "tx_fee", "tx", "size" ], "default": "no" } }, { "$ref": "#/components/parameters/DirParam" }, { "$ref": "#/components/parameters/LimitParam" }, { "$ref": "#/components/parameters/CursorParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "description": "Summary data", "type": "object", "example": { "block_height":8051808, "max_block":21702, "max_block_epoch":267, "min_block":19345, "min_block_epoch":347, "avg_block":21336, "max_block_size":148187, "min_block_size":3, "sum_block_size":88865881612, "block":8051985, "block_with_tx":4812008 } }, "rows": { "description": "Blocks list", "type": "array", "items": { "$ref": "#/components/schemas/Block" } }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/blocks/{block_id}.json": { "get": { "tags": [ "cardano_blocks" ], "summary": "Get block", "description": "Returns block data", "parameters": [{ "name": "block_id", "in": "path", "description": "Hash or Number of the block", "required": true, "schema": { "type": "string", "format": "Hexadecimal string or integer number", "maxLength": 64 }, "example": "c952bc98ea02bdf57ddf7869d8933560dbad279d07cc96800417061390446e2d" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "allOf": [ { "$ref": "#/components/schemas/Block" }, { "type": "object", "properties": { "max_size": { "description": "Max block size in epoch", "type": "integer", "format": "int32", "example": 65536 }, "confirmation": { "description": "Number of block confirmations", "type": "integer", "format": "int32", "example": 1956618 }, "battle": { "description": "Number of block battles", "type": "integer", "format": "int32", "example": 0 }, "battles": { "description": "Block battles", "type": "object", "example": { rows: [] } }, "transactions": { "description": "Block transactions", "type": "object", "example": { rows: [{ "hash": "03fc9bcf7dbf7a20d9b7ccb76addb4bfee05fca21e81c4123f2c6ca4b653ee96", "block_index": 14, "size": 535, "amount": "898876404", "out_sum": "1895154952", "fee": "179097", "deposit": "0", "script_size": 0, "token": 0 }, { "hash": "ab51c3d086438e6405f03f3383b8abbaaf20d667ccc32a9cefa20d9582862ba8", "block_index": 13, "size": 731, "amount": "100000000", "out_sum": "221242949", "fee": "187721", "deposit": "0", "script_size": 0, "token": 10 }] } }, "previous": { "description": "Previous block", "type": "object", "nullable": true, "items": { "$ref": "#/components/schemas/Block" }, "example": {"no":6097209,"hash":"c0658a8e5491257ac74adc0a18b8e5232414689930117a70f71a292e7ba92ceb","epoch_no":283,"slot_no":37099315,"epoch_slot_no":206515,"time":1628665606,"size":2769,"tx_amount":"333425038877","tx_out_sum":"343360577553","tx_fee":"1254105","tx":7,"pool_hash":"cf69a3eca039d537acd46d5864a54dd8953f0c14be957350905834aa","pool_bech32":"pool1ea568m9q882n0tx5d4vxff2dmz2n7rq5h62hx5ystq625m4tcfu","pool_name":"Nu.Fi & AdaLite 6","pool_ticker":"NUFI6"} }, "next": { "description": "Next block", "type": "object", "nullable": true, "items": { "$ref": "#/components/schemas/Block" }, "example": {"no":6097211,"hash":"0b3161768043d37edbe6b57c5aa9bb880472c39fc1df70b45b9874c54ac8a8d9","epoch_no":283,"slot_no":37099351,"epoch_slot_no":206551,"time":1628665642,"size":2654,"tx_amount":"1306923249","tx_out_sum":"98745521367","tx_fee":"938667","tx":5,"pool_hash":"aef742cd720083790f58b8dced44b868e2496335061c2c5256b44e45","pool_bech32":"pool14mm59ntjqzphjr6chrww639cdr3yjce4qcwzc5jkk38y22u7uc6","pool_name":"ZZZ2","pool_ticker":"ZZZ2"} } } } ] } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/transactions.json": { "get": { "tags": [ "cardano_txs" ], "summary": "Get transactions list", "description": "Returns data by each transaction", "parameters": [{ "name": "rows", "in": "query", "description": "Include or not rows", "schema": { "type": "string", "enum": [ "true", "false" ], "default": false } }, { "name": "sort", "in": "query", "description": "Sort transactions by field", "schema": { "type": "string", "enum": [ "time", "amount", "out_sum", "fee", "deposit", "size", "token", "script_size" ], "default": "time" } }, { "$ref": "#/components/parameters/DirParam" }, { "$ref": "#/components/parameters/LimitParam" }, { "$ref": "#/components/parameters/CursorParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "description": "Summary data", "type": "object", "example": { "tx":55272768, "tx_out_sum":"19137891440279669970", "tx_fee":"16072245383522", "tx_amount":"11261494303814733361", "max_tx":1566974, "max_tx_epoch":304, "min_tx":33, "min_tx_epoch":0, "avg_tx":145975, "live_load":0.29, "live_tps":0.87 } }, "rows": { "description": "Transactions list", "type": "array", "items": { "$ref": "#/components/schemas/Tx" } }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/transactions/{tx_id}.json": { "get": { "tags": [ "cardano_txs" ], "summary": "Get transaction", "description": "Returns transaction data", "parameters": [{ "name": "tx_id", "in": "path", "description": "Hash of the transaction", "required": true, "schema": { "type": "string", "format": "Hexadecimal string", "minLength": 64, "maxLength": 64 }, "example": "03fc9bcf7dbf7a20d9b7ccb76addb4bfee05fca21e81c4123f2c6ca4b653ee96" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "allOf": [ { "$ref": "#/components/schemas/Tx" }, { "type": "object", "properties": { "confirmation": { "description": "Number of tx confirmations", "type": "integer", "format": "int32", "example": 200 }, "certificate": { "description": "Number of certificates", "type": "integer", "format": "int32", "example": 0 }, "inputs": { "description": "Transaction inputs", "type": "object", "example": { "rows": [{ "utxo_hash": "87e066b451a147f82b0909bd9e5977328e6dbb870a4b9f2d22b03152b16c4b15", "utxo_index": 2, "index": "0", "amount": "174613236", "address": "addr1q9r8ge0za6dq850dmqmeycjeyu0kf4jcsmp0hslf9ww0cypzsq6j0d3jfs62q5ttr7ppy2vy5qd96l6ngky6ex2mqeesp0st87", "account_hash": "22803527b6324c34a0516b1f82122984a01a5d7f534589ac995b0673", "reward_address": "stake1uy3gqdf8kceycd9q2943lqsj9xz2qxja0af5tzdvn9dsvucerghya", "tokens": [], "token": 0 } ] } }, "outputs": { "description": "Transaction outputs", "type": "object", "example": { "rows": [{ "index": 0, "amount": "20000000", "address": "addr1zxgx3far7qygq0k6epa0zcvcvrevmn0ypsnfsue94nsn3tvpw288a4x0xf8pxgcntelxmyclq83s0ykeehchz2wtspks905plm", "account_hash": "81728e7ed4cf324e1323135e7e6d931f01e30792d9cdf17129cb806d", "reward_address": "stake1uxqh9rn76n8nynsnyvf4ulndjv0srcc8jtvumut3989cqmgjt49h6", "tokens": [], "token": 0 } ] } }, "withdrawals": { "description": "Transaction withdrawals", "type": "object", "example": { "rows": [] } }, "reserves": { "description": "Transaction reserves", "type": "object", "example": { "rows": [] } }, "treasury": { "description": "Transaction treasury", "type": "object", "example": { "rows": [] } }, "metadata": { "description": "Transaction metadata", "type": "object", "example": { "rows": [] } }, "stake_registrations": { "description": "Transaction stake registrations", "type": "object", "example": { "rows": [] } }, "delegations": { "description": "Transaction delegations", "type": "object", "example": { "rows": [] } }, "stake_deregistrations": { "description": "Transaction stake deregistrations", "type": "object", "example": { "rows": [] } }, "pool_updates": { "description": "Transaction pool updates", "type": "object", "example": { "rows": [] } }, "pool_retirements": { "description": "Transaction pool retirements", "type": "object", "example": { "rows": [] } }, "previous": { "description": "Previous transaction", "type": "object", "nullable": true, "items": { "$ref": "#/components/schemas/Tx" }, "example": { "hash": "0d10b6aefb64e06a61106ff505f830fd14745df4475519f6642c10233022c661", "block_no": 8054144, "block_index": 34, "block_hash": "47aeffb1232fd7a2a9df05099fa6dd95f9799f0c2aeea7f3c39039f52c25e7c9", "epoch_no": 377, "slot_no": 77722727, "epoch_slot_no": 221927, "time": 1669289018, "size": 289, "amount": "2800000", "out_sum": "61591588", "fee": "168317", "deposit": "0", "script_size": 0, "token": 0 } }, "next": { "description": "Next transaction", "type": "object", "nullable": true, "items": { "$ref": "#/components/schemas/Tx" }, "example": { "hash": "64fbbd585c8715045ac43307324080dd44bc39f3f770d20a3d60f0bfd0c5bdb8", "block_no": 8054145, "block_index": 0, "block_hash": "e6cc2c4f8ef5a7ee2d1f4440c87a9effe9f9f45aadf24954c476e0a4059a4fb1", "epoch_no": 377, "slot_no": 77722763, "epoch_slot_no": 221963, "time": 1669289054, "size": 843, "amount": "1804000000", "out_sum": "2574409774", "fee": "204661", "deposit": "0", "script_size": 0, "token": 4 } } } } ] } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/pools.json": { "get": { "tags": [ "cardano_pools" ], "summary": "Get pools list", "description": "Returns data by each pool", "parameters": [{ "name": "rows", "in": "query", "description": "Include or not rows", "schema": { "type": "string", "enum": [ "true", "false" ], "default": false } }, { "name": "sort", "in": "query", "description": "Sort pools by field", "schema": { "type": "string", "enum": [ "reg_time", "active_stake", "live_stake", "delegator", "block_epoch", "total_block", "block", "margin", "fixed_cost", "pledge", "owner_stake", "reward_amount", "pool_fee", "leverage" ], "default": "reg_time" } }, { "$ref": "#/components/parameters/DirParam" }, { "$ref": "#/components/parameters/LimitParam" }, { "$ref": "#/components/parameters/CursorParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "description": "Summary data", "type": "object", "example": {"pool":3233,"pool_with_stake":2975,"pool_with_block":2809,"pool_retired":2163,"delegator":1233371,"delegator_with_stake":1207466,"stake":"25038445746818385","rewarded_account":1408842,"reward_amount":"1912128776814900","pool_fee":"398375264013305","saturation_point":"70351357960826"} }, "rows": { "description": "Pools list", "type": "array", "items": { "$ref": "#/components/schemas/Pool" } }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/pools/{pool_id}.json": { "get": { "tags": [ "cardano_pools" ], "summary": "Get pool", "description": "Returns pool data", "parameters": [{ "name": "pool_id", "in": "path", "description": "Hash or Bech32 of the pool", "required": true, "schema": { "type": "string", "format": "Hexadecimal string or Bech32 string" }, "example": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, { "name": "rows", "in": "query", "description": "Rows type", "schema": { "type": "string", "enum": [ "epochs", "blocks", "orphan_blocks", "delegators", "delegations", "updates" ], "default": null } }, { "name": "sort", "in": "query", "description": "Sort field", "schema": { "type": "string", "enum": [ "no", "reward_amount", "ros", "stake", "delegator", "margin", "fixed_cost", "pledge", "pool_fee", "block", "epoch_stake", "no", "tx", "tx_amount", "tx_out_sum", "tx_fee", "size", "no", "live_stake", "total_reward_amount", "time", "time", "pledge", "margin", "fixed_cost", "active_epoch_no" ], "default": null } }, { "$ref": "#/components/parameters/DirParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "allOf": [ { "$ref": "#/components/schemas/Pool" }, { "type": "object", "properties": { "description": { "description": "The description of the pool", "type": "string", "example": "This pool allows us to sustain and improve AdaStat.net Cardano Explorer" }, "homepage": { "description": "The homepage of the pool", "type": "string", "example": "https://adastat.net/" }, "extended_data": { "description": "Extended metadata of pool if exists", "type": "object", "example": { "itn": { "owner": "ed25519_pk1ua5g7xx2fu3kttpmuqx0caqgjk43kzq0jguj79lskry05w6pl3zq85pp69", "witness": "ed25519_sig1mrh9rkfpgp8qq7mdkwfqhjn6apjyjkwcduh9fn64u5hm6quewmxvtd36x4s24krapgvevt7caku0ftssnhm2s0eddklkeclnf0hujqcuzqddy" }, "info": { "social": { "twitch_handle": "", "discord_handle": "", "twitter_handle": "ada_stat", "youtube_handle": "", "facebook_handle": "", "telegram_handle": "" }, "location": "Düsseldorf, Germany", "url_png_logo": "https://adastat.net/img/logo.png", "url_png_icon_64x64": "https://adastat.net/img/logo-64x64.png" }, "my-pool-ids": { "0": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, "telegram-admin-handle": { "0": "dmitry_stas" }, "when-satured-then-recommend": { "0": "660f2b816e90e4e826daebf33357d76ab89414f88d57dd7d9f7898fe", "1": "fcbfb4a3c18f890de7a51f68603b18e654f8b432abdda17c53a0d586" } } }, "update_time": { "description": "Update pool timestamp", "type": "integer", "format": "int32", "example": 1638199825 }, "reg_tx_hash": { "description": "Registration tx hash", "type": "string", "format": "Hexadecimal", "example": "994cb6b50d204b522f0c9bd9c1559a3df933e2848b2ba7f79471f628497f4fde" }, "update_tx_hash": { "description": "Latest update tx hash", "type": "string", "format": "Hexadecimal", "example": "134b5d435a1f9b1945bc92fc44a6ce7a28e66b1cba420afcd9197c3b68e43e5b" }, "announced_margin": { "description": "Announced (in the current epoch) pool margin", "type": "integer", "format": "percentage ratio", "example": "0" }, "announced_fixed_cost": { "description": "Announced (in the current epoch) pool fixed cost", "type": "integer", "format": "int64", "example": "340000000" }, "announced_pledge": { "description": "Announced (in the current epoch) pool pledge", "type": "integer", "format": "int64", "example": "220000000000" }, "luck": { "description": "Pool luck", "type": "object", "format": "key = number of epochs, 0 = all epochs, value = percentage luck", "example": { "0": "1.0071", "1": "0.6553", "2": "0.8634", "3": "0.9197", "6": "0.9786", "12": "0.9878", "18": "0.9721", "36": "0.9800", "73": "0.9709" } }, "stake_snapshot": { "description": "Pool stake snapshot data", "type": "object", "example": { "pool_stake_mark": "61863959698902", "pool_stake_set": "60976369674208", "pool_stake_go": "60736396496475", "active_stake_mark": "25116738054461618", "active_stake_set": "25197315592272395", "active_stake_go": "25272403210023564" } }, "live_saturation": { "description": "Live saturation", "type": "number", "format": "percentage ratio", "example": "0.8855" }, "active_saturation": { "description": "Active saturation", "type": "number", "format": "percentage ratio", "example": "0.8676" }, "orphan_block" : { "description": "Pool has orphan blocks", "type": "boolean", "example": true }, "blocks_probability": { "description": "Current epoch blocks probability", "type": "object", "example": { "38": 0.0075, "39": 0.01, "40": 0.0131, "41": 0.0167, "42": 0.0208, "43": 0.0253, "44": 0.03, "45": 0.0349, "46": 0.0397, "47": 0.0441, "48": 0.0481, "49": 0.0513, "50": 0.0536, "51": 0.055, "52": 0.0553, "53": 0.0545, "54": 0.0528, "55": 0.0501, "56": 0.0468, "57": 0.0429, "58": 0.0387, "59": 0.0342, "60": 0.0298, "61": 0.0255, "62": 0.0215, "63": 0.0179, "64": 0.0146, "65": 0.0117, "66": 0.0093 } } } } ] }, "rows": { "oneOf": [ { "title": "Epochs", "type": "array", "items": { "description": "Pool epochs data", "type": "object", "example": { "epoch_no": 376, "reward_amount": null, "ros": null, "stake": "60736396496475", "delegator": "5582", "margin": "0", "fixed_cost": "340000000", "pledge": "220000000000", "pool_fee": null, "block": 46, "epoch_stake": "61863959698902", "owner_stake": "270429379164", "orphaned_reward_amount": "0", "estimated_block": "51.91" } } }, { "title": "Blocks", "type": "array", "items": { "description": "Pool blocks data", "type": "object", "example": {"no":8058819,"hash":"84ac003d3b74e296ec5c9eec2d6175f4ac5bca0a251f7e45e06017c62d667933","epoch_no":377,"slot_no":77818997,"epoch_slot_no":318197,"time":1669385288,"size":80972,"tx_amount":"9332862656","tx_out_sum":"1301031808374","tx_fee":"13926633","tx":54} } }, { "title": "Orphan blocks", "type": "array", "items": { "description": "Pool orphan blocks data", "type": "object", "example": {"orphan_hash":"4a4ff9ee7176356090abab78eb6259758791cff773460df26442b33c4057c862","orphan_epoch_no":377,"orphan_epoch_slot_no":283332,"orphan_no":8057138,"orphan_slot_no":77784132,"orphan_size":4485,"orphan_tx":3,"orphan_time":1669350423,"hash":"426ad818a0332247690254062d662d96d27f965b2a65f308a85c71a87897e7ec","epoch_no":377,"epoch_slot_no":283332,"no":8057138,"slot_no":77784132,"size":4485,"tx":3,"time":1669350423,"pool_hash":"abacadaba9f12a8b5382fc370e4e7e69421fb59831bb4ecca3a11d9b","pool_bech32":"pool14wk2m2af7y4gk5uzlsmsunn7d9ppldvcxxa5an9r5ywek8330fg","pool_name":"竜SM₳UG","pool_ticker":"SMAUG"} } }, { "title": "Delegators", "type": "array", "items": { "description": "Pool delegators data", "type": "object", "example": {"hash":"4d97a2d88b0b841a1fe0e478991a3e3ad8965d2e56e0db58461b33b1","bech32":"stake1u9xe0gkc3v9cgxslurj83xg68cad39ja9etwpk6cgcdn8vgrpclme","live_stake":"4229966421839","total_reward_amount":"429419465220","tx_hash":"ad65a817d4682e4f100f8b2ac4f96639c0bf177cf8698cf5156e555171a9827a","epoch_no":333,"epoch_slot_no":384302,"slot_no":58877102,"tx_time":1650443393,"from_pool_hash":"83f09b0af923a095a1c17905e802a35d1044f974b25d2a755a2d8266","from_pool_bech32":"pool1s0cfkzheywsftgwp0yz7sq4rt5gyf7t5kfwj5a269kpxvndjn6q","from_pool_name":"ADA Ocean Five","from_pool_ticker":"OCEA5"} } }, { "title": "Delegations", "type": "array", "items": { "description": "Pool delegations data", "type": "object", "example": {"stake":"788648176","account_hash":"033ad868400f36040dfa278e7e933460f7637eda089c82282067d7e6","reward_address":"stake1uypn4krggq8nvpqdlgncul5nx3s0wcm7mgyfeq3gypna0esqtv3nk","tx_hash":"ee791438e6693cc85ef7d3da4601fcca4005109a18dc79e0f021840aee27f012","epoch_no":377,"epoch_slot_no":308483,"time":1669375574,"from_pool_hash":"77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1","from_pool_bech32":"pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch","from_pool_name":"AdaStat Pool","from_pool_ticker":"STAT","to_pool_hash":"a10865dae2d543ee9f13e98bff70ea81565bb6e4343b15b765f78174","to_pool_bech32":"pool15yyxtkhz64p7a8cnax9l7u82s9t9hdhyxsa3tdm977qhgpnsuhq","to_pool_name":"ONE SecureStaking.io","to_pool_ticker":"SECUR","active_epoch_no":"379"} } }, { "title": "Updates", "type": "array", "items": { "description": "Pool updates data", "type": "object", "example": {"pledge":"220000000000","active_epoch_no":"308","margin":"0","fixed_cost":"340000000","vrf_key_hash":"e250a7a87627c07a67519be1470a0980f189cfaa6ef98a4312dc844c2c75f653","reward_address":"stake1u8vmjew3l4cfqyzrhmt7xmvy63v9ycrdv0tnhgd7hmtvz5c525265","meta_url":"https://adastat.net/stat.metadata.json","meta_hash":"814de888f1a187451743f469ecf05d55561488c5cc4982e7331aeb1a35b983c8","meta_json":{"name":"AdaStat Pool","ticker":"STAT","extended":"https://adastat.net/stat.extended-metadata.json","homepage":"https://adastat.net/","description":"This pool allows us to sustain and improve AdaStat.net Cardano Explorer"},"tx_hash":"134b5d435a1f9b1945bc92fc44a6ce7a28e66b1cba420afcd9197c3b68e43e5b","epoch_no":305,"epoch_slot_no":236734,"time":1638199825,"owners":[{"account_hash":"f5fe8de787d0798542be9e729fe3f85ecec2af37ca6e049355ab1344","reward_address":"stake1u86lar08slg8np2zh60898lrlp0vas40xl9xupyn2k43x3qrawyzr"},{"account_hash":"d9b965d1fd70901043bed7e36d84d45852606d63d73ba1bebed6c153","reward_address":"stake1u8vmjew3l4cfqyzrhmt7xmvy63v9ycrdv0tnhgd7hmtvz5c525265"}]} } } ] }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/accounts.json": { "get": { "tags": [ "cardano_accounts" ], "summary": "Get accounts list", "description": "Returns data by each account", "parameters": [{ "name": "rows", "in": "query", "description": "Include or not rows", "schema": { "type": "string", "enum": [ "true", "false" ], "default": false } }, { "name": "sort", "in": "query", "description": "Sort accounts by field", "schema": { "type": "string", "enum": [ "balance", "total_reward_amount", "token", "first_tx", "last_tx", "tx" ], "default": "balance" } }, { "$ref": "#/components/parameters/DirParam" }, { "$ref": "#/components/parameters/LimitParam" }, { "$ref": "#/components/parameters/CursorParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "description": "Summary accounts data", "type": "object", "example": { "account": 3740347, "account_with_amount": 2082596, "delegator": 1234106, "delegator_with_stake": 1207895, "shelley_amount": "31851725712798244", "stake": "25045333924071764", "reward_amount": "2310504040828205", "byron": 11190513, "byron_with_amount": 321676, "byron_amount": "2569613468532157" } }, "rows": { "description": "Accounts list", "type": "array", "items": { "$ref": "#/components/schemas/Account" } }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/accounts/{account_id}.json": { "get": { "tags": [ "cardano_accounts" ], "summary": "Get account", "description": "Returns account data", "parameters": [{ "name": "account_id", "in": "path", "description": "Hash or Bech32 of the account", "required": true, "schema": { "type": "string", "format": "Hexadecimal string or Bech32 string" }, "example": "d9b965d1fd70901043bed7e36d84d45852606d63d73ba1bebed6c153" }, { "name": "rows", "in": "query", "description": "Rows type", "schema": { "type": "string", "enum": [ "history", "rewards", "mir", "refunds", "tokens", "addresses", "delegations", "key_history" ], "default": null } }, { "$ref": "#/components/parameters/DirParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "allOf": [ { "$ref": "#/components/schemas/Account" }, { "type": "object", "properties": { "reward_balance": { "description": "Live rewards amount", "type": "integer", "format": "int64", "example": "11169417143" }, "active_stake": { "description": "Active stake", "type": "integer", "format": "int64", "example": "260518751481" }, "snapshot_stake": { "description": "Stake in past snapshot", "type": "integer", "format": "int64", "example": "260981414925" }, "catalyst_id": { "description": "Wallet ID from Catalyst voting app", "type": "string", "format": "Hexadecimal", "example": "d1fb6ea2de9c0b02c07eafd75c000d8114019c4b08082b41e87a3fdf62e2dacc" }, "address": { "description": "Number of addresses", "type": "integer", "format": "int32", "example": 11 }, "registered_stake_key": { "description": "Stake key is registered", "type": "boolean", "example": true }, "stake_history": { "description": "Stake key has delegation history", "type": "boolean", "example": true }, "key_history": { "description": "Stake key has registration/deregistration history", "type": "boolean", "example": true }, "active_pool_hash": { "description": "Account active pool hash", "type": "string", "format": "Hexadecimal", "minLength": 56, "maxLength": 56, "example": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, "active_pool_bech32": { "description": "Account active pool bech32", "type": "string", "example": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch" }, "active_pool_name": { "description": "Account active pool name", "type": "string", "example": "AdaStat Pool" }, "active_pool_ticker": { "description": "Account active pool ticker", "type": "string", "example": "STAT" }, "snapshot_pool_hash": { "description": "Account snapshot pool hash", "type": "string", "format": "Hexadecimal", "minLength": 56, "maxLength": 56, "example": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, "snapshot_pool_bech32": { "description": "Account snapshot pool bech32", "type": "string", "example": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch" }, "snapshot_pool_name": { "description": "Account snapshot pool name", "type": "string", "example": "AdaStat Pool" }, "snapshot_pool_ticker": { "description": "Account snapshot pool ticker", "type": "string", "example": "STAT" }, "first_reward_epoch": { "description": "First rewards epoch no", "type": "integer", "format": "int32", "example": 256 }, "last_reward_epoch": { "description": "Latest rewards epoch no", "type": "integer", "format": "int32", "example": 376 }, "total_member": { "description": "Number of member (delegator) rewards", "type": "integer", "format": "int32", "example": 1 }, "total_leader": { "description": "Number of leader (pool reward address) rewards", "type": "integer", "format": "int32", "example": 120 }, "total_refund": { "description": "Number of pool deposit refund", "type": "integer", "format": "int32", "example": 0 }, "total_treasury": { "description": "Number of tx from treasury", "type": "integer", "format": "int32", "example": 6 }, "total_reserves": { "description": "Number of tx from reserves", "type": "integer", "format": "int32", "example": 2 }, "total_refund_amount": { "description": "Amount of pool deposit refund", "type": "integer", "format": "int64", "nullable": true, "example": null }, "pool_reward_address": { "description": "In case account is pool reward address", "type": "object", "example": { "rows": [{ "pool_hash": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1", "pool_bech32": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch", "pool_name": "AdaStat Pool", "pool_ticker": "STAT" } ] } }, "pool_owner": { "description": "In case account is pool owner", "type": "object", "example": { "rows": [{ "pool_hash": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1", "pool_bech32": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch", "pool_name": "AdaStat Pool", "pool_ticker": "STAT" } ] } } } } ] }, "rows": { "oneOf": [ { "title": "History", "type": "array", "items": { "description": "Account transaction history", "type": "object", "example": {"tx_hash":"aa5b1dcd0cac88d931110d4cd0763e7dd44e6bd29bbb6c8c76376fac4e6a2e7d","tx_fee":"168669","tx_deposit":"0","block_no":7639445,"block_index":1,"block_hash":"fa09cf8bb6c85183191620cbf7c8d2dbf184f0d76fbd91fdda0e4102f9468311","epoch_no":357,"slot_no":69212082,"epoch_slot_no":351282,"time":1660778373,"amount":"5000000000","token":0,"tokens":{"rows":[]}} } }, { "title": "Rewards", "type": "array", "items": { "description": "Account rewards history", "type": "object", "example": {"stake":"259602302718","earned_epoch_no":376,"pool_hash":"77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1","pool_bech32":"pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch","pool_name":"AdaStat Pool","pool_ticker":"STAT","pool_block":46,"broken_pledge":false,"type":"leader","amount":"462663444","epoch_no":378,"slot_no":77932845,"epoch_slot_no":45,"time":1669499136,"pool_pledge_met":true} } }, { "title": "MIR", "type": "array", "items": { "description": "Account MIR history", "type": "object", "example": {"type":"treasury","amount":"756645190","earned_epoch_no":374,"epoch_no":375,"slot_no":76637018,"epoch_slot_no":218,"time":1668203309} } }, { "title": "Refunds", "type": "array", "items": { "description": "Account refunds history", "type": "object", "example": null } }, { "title": "Tokens", "type": "array", "items": { "description": "Account tokens", "type": "object", "example": {"policy":"7ea3e7719938f8acd700327d6c9dffd7523a02dce1d9891b5f3a452d","asset_name":"BlockOwlsSpots092","asset_name_hex":"426c6f636b4f776c7353706f7473303932","fingerprint":"asset1nx9fl8z5xetrm7y22ymduu57d32nkhj9e7m83r","quantity":"1","image":"ipfs://QmPA64YBTRm59ZNWK5bVzut78rUgFKqu8MEj92HXA54DQ4","name":"BlockOwls Spots","ticker":"","decimals":0,"image_nonce":"13239508"} } }, { "title": "Addresses", "type": "array", "items": { "description": "Account addresses", "type": "object", "example": {"address":"addr1q9pljtj73jfmjxav3uuf7s43k82aueyq677w4t6nam03h7weh9jarltsjqgy80khudkcf4zc2fsx6c7h8wsma0kkc9fswxzquv","balance":"29916383286","tx":1,"token":0,"first_tx_hash":"38e076d30d55b4cd23e3b89af4fc4bdf48712d6243488cbb24e734a4508f234b","first_tx_time":1636709947,"last_tx_hash":"38e076d30d55b4cd23e3b89af4fc4bdf48712d6243488cbb24e734a4508f234b","last_tx_time":1636709947} } }, { "title": "Delegations", "type": "array", "items": { "description": "Account delegations history", "type": "object", "example": {"active_epoch_no":"256","amount":"18997825567","tx_hash":"05672196969553751798dd9e80f75811e98e17970c46a737bff697efffbc6360","time":1616107769,"epoch_no":254,"epoch_slot_no":176678,"slot_no":24541478,"block_no":5478471,"block_hash":"75516a0a0be2728b495264d175d511d8d7526069941b5b50d8fdd70aee33bb63","from_pool_hash":"77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1","from_pool_bech32":"pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch","from_pool_name":"AdaStat Pool","from_pool_ticker":"STAT","to_pool_hash":"77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1","to_pool_bech32":"pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch","to_pool_name":"AdaStat Pool","to_pool_ticker":"STAT"} } }, { "title": "Key history", "type": "array", "items": { "description": "Account stake key history", "type": "object", "example": {"type":"registration","epoch_no":254,"block_hash":"6ed9e9672c744bc2d8bc822c31b8b7a283f32c0841f4ee9aecb3006223d309da","block_no":5478266,"tx_hash":"b66fcbf15bd887ad9d636cc9b50a202c071cc753ccbc9e475f34bfae5bb38a78","cert_index":0,"deposit_amount":"2000000","slot_no":24536439,"epoch_slot_no":171639,"time":1616102730} } } ] }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/addresses/{address}.json": { "get": { "tags": [ "cardano_addresses" ], "summary": "Get address", "description": "Returns address data", "parameters": [{ "name": "address", "in": "path", "description": "Address", "required": true, "schema": { "type": "string", "format": "Bech32 (Shelley) or Base58 (Byron) string" }, "example": "addr1qxdewlgy6eks75pthe7a6qagavrad4dmfausf990f2c0s7xeh9jarltsjqgy80khudkcf4zc2fsx6c7h8wsma0kkc9fscq0my5" }, { "name": "rows", "in": "query", "description": "Rows type", "schema": { "type": "string", "enum": [ "history", "tokens", "utxos" ], "default": null } }, { "$ref": "#/components/parameters/DirParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "allOf": [ { "$ref": "#/components/schemas/Address" }, { "type": "object", "properties": { "account_hash": { "description": "Account hash", "type": "string", "format": "Hexadecimal", "example": "d9b965d1fd70901043bed7e36d84d45852606d63d73ba1bebed6c153" }, "reward_address": { "description": "Account reward address", "type": "string", "format": "bech32", "example": "stake1u8vmjew3l4cfqyzrhmt7xmvy63v9ycrdv0tnhgd7hmtvz5c525265" }, "account_balance": { "description": "Account balance (live stake)", "type": "string", "format": "int64", "example": "260981414925" }, "account_reward_balance": { "description": "Account rewards balance", "type": "string", "format": "int64", "example": "11169417143" }, "account_total_reward_amount": { "description": "Account earned rewards amount for all time", "type": "string", "format": "int64", "example": "69577988751" }, "account_active_stake": { "description": "Account active stake", "type": "string", "format": "int64", "example": "260518751481" }, "account_snapshot_stake": { "description": "Account snapshot stake", "type": "string", "format": "int64", "example": "260518751481" }, "registered_stake_key": { "description": "Stake key is registered", "type": "boolean", "example": true }, "active_pool_hash": { "description": "Account active pool hash", "type": "string", "format": "Hexadecimal", "minLength": 56, "maxLength": 56, "example": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, "active_pool_bech32": { "description": "Account active pool bech32", "type": "string", "example": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch" }, "active_pool_name": { "description": "Account active pool name", "type": "string", "example": "AdaStat Pool" }, "active_pool_ticker": { "description": "Account active pool ticker", "type": "string", "example": "STAT" }, "snapshot_pool_hash": { "description": "Account snapshot pool hash", "type": "string", "format": "Hexadecimal", "minLength": 56, "maxLength": 56, "example": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, "snapshot_pool_bech32": { "description": "Account snapshot pool bech32", "type": "string", "example": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch" }, "snapshot_pool_name": { "description": "Account snapshot pool name", "type": "string", "example": "AdaStat Pool" }, "snapshot_pool_ticker": { "description": "Account snapshot pool ticker", "type": "string", "example": "STAT" }, "hash": { "description": "Address hash", "type": "string", "format": "Hexadecimal", "example": "019b977d04d66d0f502bbe7ddd03a8eb07d6d5bb4f790494af4ab0f878d9b965d1fd70901043bed7e36d84d45852606d63d73ba1bebed6c153" }, "type": { "description": "Address type", "type": "string", "example": "base" }, "type_int": { "description": "Address type integer", "type": "string", "example": 0 } } } ] }, "rows": { "oneOf": [ { "title": "history", "type": "array", "items": { "description": "Address transaction history", "type": "object", "example": {"tx_hash":"93ee812870cb19b6389cc6cc7dae54e8e0f20055909eab07ac38e1b0580ff084","tx_fee":"180505","tx_deposit":"0","block_no":7966678,"block_index":19,"block_hash":"0bd456bff2cbd50101edcded2c06089b05ace658bb4a7f8470217fb9b1e2e8da","epoch_no":373,"slot_no":75909339,"epoch_slot_no":136539,"time":1667475630,"amount":"1168010","token":1,"tokens":{"rows":[{"policy":"f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a","asset_name":"adastat.net","asset_name_hex":"616461737461742e6e6574","fingerprint":"asset1w39nm0zdha30vhq47a2y0qfh8qv3tj6y7fq7kf","name":"$adastat.net","ticker":"","decimals":0,"quantity":"1"}]}} } }, { "title": "tokens", "type": "array", "items": { "description": "Address tokens", "type": "object", "example": {"policy":"f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a","asset_name":"adastat.net","asset_name_hex":"616461737461742e6e6574","fingerprint":"asset1w39nm0zdha30vhq47a2y0qfh8qv3tj6y7fq7kf","quantity":"1","image":"ipfs://QmPj4szDMSwyGCUq2c3zT8SmTvbzw7vfUCDGQNVqiZmQah","name":"$adastat.net","ticker":"","decimals":0,"image_nonce":"51704472"} } }, { "title": "utxos", "type": "array", "items": { "description": "Address UTXOs", "type": "object", "example": {"tx_hash":"93ee812870cb19b6389cc6cc7dae54e8e0f20055909eab07ac38e1b0580ff084","tx_index":0,"amount":"1168010","token":1,"tokens":{"rows":[{"policy":"f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a","asset_name":"adastat.net","asset_name_hex":"616461737461742e6e6574","fingerprint":"asset1w39nm0zdha30vhq47a2y0qfh8qv3tj6y7fq7kf","name":"$adastat.net","ticker":"","decimals":0,"quantity":"1"}]}} } } ] }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/tokens.json": { "get": { "tags": [ "cardano_tokens" ], "summary": "Get tokens list", "description": "Returns data by each token", "parameters": [{ "name": "rows", "in": "query", "description": "Include or not rows", "schema": { "type": "string", "enum": [ "true", "false" ], "default": false } }, { "name": "sort", "in": "query", "description": "Sort tokens by field", "schema": { "type": "string", "enum": [ "first_tx", "last_tx", "supply", "tx", "holder" ], "default": "first_tx" } }, { "$ref": "#/components/parameters/DirParam" }, { "$ref": "#/components/parameters/LimitParam" }, { "$ref": "#/components/parameters/CursorParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "description": "Summary tokens data", "type": "object", "example": { "token": 7056235, "tx": 26030238, "holder": 488556, "policy": 65661 } }, "rows": { "description": "Tokens list", "type": "array", "items": { "$ref": "#/components/schemas/Token" } }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/tokens/{token_id}.json": { "get": { "tags": [ "cardano_tokens" ], "summary": "Get token", "description": "Returns token data", "parameters": [{ "name": "token_id", "in": "path", "description": "Token", "required": true, "schema": { "type": "string", "format": "PolicyID + AssetName string" }, "example": "fbfef0c4d74ae29cb8e2f80bb58cb2ea22d023a0f427214a9c10d0d15468654d616e6472696c6c7a576f726c64637570393523333332" }, { "name": "rows", "in": "query", "description": "Rows type", "schema": { "type": "string", "enum": [ "transactions", "minting", "holders" ], "default": null } }, { "$ref": "#/components/parameters/DirParam" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 200 }, "data": { "allOf": [ { "$ref": "#/components/schemas/Token" }, { "type": "object", "properties": { "script": { "description": "Token script", "type": "object", "example": { "type": "all", "scripts": [{ "slot": 108753976, "type": "before" }, { "type": "sig", "keyHash": "07b3a412133de8bc7ac0646216aee7498f05b633ddde946d9ff6adfe" } ] } }, "description": { "description": "Token description from metadata", "type": "string", "example": "TheMandrillzWorldcup Number 95" }, "url": { "description": "https://themandrillz.io", "type": "string", "example": "TheMandrillzWorldcup Number 95" }, "metadata": { "no": "1", "top": "none", "body": "nuclear", "eyes": "god", "face": "whistle", "head": "nuclear", "name": "TheMandrillzWorldcup #95", "team": "Australia", "bling": "diamond", "image": "ipfs://QmYe8J2jLTxYZh94DLkapKxmLyUBBvFNKC8iqKPkbYLJtP", "artist": "@Seppow86", "clothes": "jersey australia goalkeeper", "glasses": "none", "holding": "glove australia flag tmz", "special": "ball", "twitter": "https://twitter.com/TheMandrillz", "website": "https://themandrillz.io", "position": "Goalkeeper", "seriesno": "332", "occurance": "common", "background": "australia", "description": "TheMandrillzWorldcup Number 95" }, "nft": { "description": "Token is NFT", "type": "boolean", "example": false }, "locked": { "description": "Token minting is not allowed", "type": "boolean", "example": false }, "registry": { "description": "Token has offchain metadata (https://github.com/cardano-foundation/cardano-token-registry)", "type": "boolean", "example": false }, "policy_token": { "description": "Number of tokens of token policy", "type": "string", "format": "int32", "example": 79156 }, "policy_holder": { "description": "Number of total holders of all tokens of policy", "type": "string", "format": "int32", "example": 830 } } } ] }, "rows": { "oneOf": [ { "title": "transactions", "type": "array", "items": { "description": "Token transaction history", "type": "object", "example": {"quantity":"1","tx_hash":"3aec7b9ef665da29cf60cdc6b48e9e86f9c1b03dd389f8534c44840ffbecb967","block_no":8067061,"block_index":0,"block_hash":"2c86a22ba46848231fd81289daf9d94d3581c9fcf41b6bf0b6d934a87d9f33c5","epoch_no":378,"slot_no":77990025,"epoch_slot_no":57225,"time":1669556316} } }, { "title": "minting", "type": "array", "items": { "description": "Token minting history", "type": "object", "example": {"quantity":"1","tx_hash":"cafc77f1f5bf727cfd104195831448f929c1883a82e67d2df9531f9f676f4b54","block_no":8067022,"block_index":10,"block_hash":"1c8a6cc59d0f8b37a4a343bea33f61684580999d2355905f93411c0569376631","epoch_no":378,"slot_no":77989211,"epoch_slot_no":56411,"time":1669555502} } }, { "title": "holders", "type": "array", "items": { "description": "Token holders", "type": "object", "example": {"quantity":"1","address":"addr1zxgx3far7qygq0k6epa0zcvcvrevmn0ypsnfsue94nsn3tvpw288a4x0xf8pxgcntelxmyclq83s0ykeehchz2wtspks905plm","account_hash":"81728e7ed4cf324e1323135e7e6d931f01e30792d9cdf17129cb806d"} } } ] }, "cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "code", "data" ] } } } }, "400": { "$ref": "#/components/responses/400" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } } }, "components": { "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 400 }, "error": { "description": "Error description", "type": "string", "example": "Bad Request" } }, "required": [ "code", "error" ] } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 404 }, "error": { "description": "Error description", "type": "string", "example": "Not Found" } }, "required": [ "code", "error" ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 429 }, "error": { "description": "Error description", "type": "string", "example": "Too Many Requests" } }, "required": [ "code", "error" ] } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "description": "Response code", "type": "integer", "format": "int32", "example": 500 }, "error": { "description": "Error description", "type": "string", "example": "Internal Server Error" } }, "required": [ "code", "error" ] } } } } }, "parameters": { "LimitParam": { "name": "limit", "in": "query", "description": "Max numbers of items on the page", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 10 } }, "CursorParam": { "name": "after", "in": "query", "description": "Cursor after", "schema": { "type": "string", "default": "" } }, "DirParam": { "name": "dir", "in": "query", "description": "Sort direction:\n * asc - Ascending, from 0 to 9 and A to Z.\n * desc - Descending, from 9 to 0 and Z to A.\n", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, "CurrencyParam": { "name": "currency", "in": "query", "description": "Currency code", "schema": { "type": "string", "enum": [ "aed", "ars", "aud", "bdt", "bhd", "bmd", "brl", "cad", "chf", "clp", "cny", "czk", "dkk", "eur", "gbp", "hkd", "huf", "idr", "ils", "inr", "jpy", "krw", "kwd", "lkr", "mmk", "mxn", "myr", "ngn", "nok", "nzd", "php", "pkr", "pln", "rub", "sar", "sek", "sgd", "thb", "try", "twd", "uah", "usd", "vef", "vnd", "zar" ], "default": "usd" } }, }, "schemas": { "Cursor": { "description": "Next page, if exist", "type": "object", "properties": { "after": { "description": "Cursor after", "type": "string", "example": "375" }, "next": { "description": "If next page exist", "type": "boolean", "example": true } } }, "Epoch": { "type": "object", "properties": { "no": { "description": "Epoch number", "type": "integer", "format": "int32", "example": 375 }, "circulating_supply": { "description": "Circulating supply", "type": "integer", "format": "int64", "example": "34408851751829176" }, "tx_amount": { "description": "Total transactions amount", "type": "integer", "format": "int64", "example": "26784938440200022" }, "out_sum": { "description": "Total output amount", "type": "integer", "format": "int64", "example": "19169937408721743" }, "fees": { "description": "Total fee amount", "type": "integer", "format": "int64", "example": "37979106429" }, "tx": { "description": "The number of transactions", "type": "integer", "format": "int32", "example": 172429 }, "block": { "description": "The number of blocks", "type": "integer", "format": "int32", "example": 21021 }, "block_with_tx": { "description": "The number of blocks with transaction", "type": "integer", "format": "int32", "example": 18889 }, "pool": { "description": "Total active pools", "type": "integer", "format": "int32", "example": 3235 }, "pool_with_block": { "description": "The number of pools that created at least 1 block", "type": "integer", "format": "int32", "example": 1117 }, "pool_with_stake": { "description": "The number of pools with at least 1 lovelace delegated", "type": "integer", "format": "int32", "example": 2980 }, "pool_fee": { "description": "The amount earned by pools as pool fee (fixed fee + margin)", "type": "integer", "format": "int64", "example": "2481052753130" }, "reward_amount": { "description": "Rewards distributed to delegators", "type": "integer", "format": "int64", "example": "10153218027687" }, "stake": { "description": "Total delegated amount", "type": "integer", "format": "int64", "example": "25197315592272395" }, "byron_amount": { "description": "Total amount on Byron addresses", "type": "integer", "format": "int64", "example": "2523042546725111" }, "delegator": { "description": "The number of delegators", "type": "integer", "format": "int32", "example": 1230026 }, "delegator_with_stake": { "description": "The number of delegators with at least 1 lovelace", "type": "integer", "format": "int32", "example": 1230026 }, "account": { "description": "The number of accounts (stake keys)", "type": "integer", "format": "int32", "example": 3697234 }, "account_with_reward": { "description": "The number of delegators with rewards", "type": "integer", "format": "int32", "example": 1141695 }, "account_with_amount": { "description": "The number of accounts with at least 1 lovelace", "type": "integer", "format": "int32", "example": 2050221 }, "byron": { "description": "The number of byron addresses", "type": "integer", "format": "int32", "example": 11172080 }, "byron_with_amount": { "description": "The number of byron addresses with at least 1 lovelace", "type": "integer", "format": "int32", "example": 327538 }, "pool_register": { "description": "The number of pools registered in this epoch", "type": "integer", "format": "int32", "example": 4 }, "pool_retire": { "description": "The number of pools retired in this epoch", "type": "integer", "format": "int32", "example": 8 }, "orphaned_reward_amount": { "description": "Rewards earned by pools but not distributed to delegators since they have unregistered stake addresses", "type": "integer", "format": "int64", "example": "10563943124" }, "token": { "description": "The number of tokens", "type": "integer", "format": "int32", "example": 6841000 }, "token_policy": { "description": "The number of token policies", "type": "integer", "format": "int32", "example": 65094 }, "token_holder": { "description": "The number of token holders", "type": "integer", "format": "int32", "example": 484470 }, "token_tx": { "description": "The number of transactions with tokens", "type": "integer", "format": "int32", "example": 210020 }, "optimal_pool_count": { "description": "Optimal pool count", "type": "integer", "format": "int32", "example": 500 }, "decentralisation": { "description": "Decentralisation", "type": "integer", "format": "int32", "example": 1 }, "nonce": { "description": "Epoch nonce", "type": "string", "format": "Hexadecimal", "example": "bb94d052f213fb98049ae2a7c4efee86cd6a0a2f16772725788da8c86cde8f77" }, "exchange_rate": { "description": "Exchange rate", "type": "number", "format": "float", "example": 0.345782 }, "start_time": { "description": "Timestamp of the first block in the epoch", "type": "integer", "format": "int32", "example": 1617648346 }, "end_time": { "description": "Timestamp of the last block in the epoch", "type": "integer", "format": "int32", "example": 1618080279 }, "holder_range": { "description": "The numbers of ranges of accounts, delegators, entreprise shelley addresses and byron addresses with at least 1 lovelace. The numeric key N means: 0 - >0 and <=10 ada, 1 - >10 and <=100 ada, 2 - >100 and <=1000 ada, etc", "type": "object", "example": {"byron":{"0":143642,"1":99534,"2":49091,"3":27162,"4":7399,"5":1835,"6":294,"7":16,"8":1,"9":0,"10":0},"account":{"0":619161,"1":423462,"2":484057,"3":355999,"4":106319,"5":18887,"6":2432,"7":396,"8":4,"9":0,"10":0},"address":{"0":21117,"1":13856,"2":20223,"3":8815,"4":730,"5":117,"6":36,"7":80,"8":3,"9":0,"10":0},"delegator":{"0":331629,"1":210151,"2":290454,"3":259914,"4":88442,"5":17062,"6":2157,"7":367,"8":1,"9":0,"10":0}} } } }, "Block": { "type": "object", "properties": { "no": { "description": "Block sequence number (block height)", "type": "integer", "format": "int32", "example": 6097210 }, "hash": { "description": "Block hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "e050a7a3fea377b15a3935a02f77d1ad186035eccfba154a658998bd31c3c12e" }, "epoch_no": { "description": "Epoch number", "type": "integer", "format": "int32", "nullable": true, "example": 283 }, "slot_no": { "description": "Slot number", "type": "integer", "format": "int32", "nullable": true, "example": 37099339 }, "epoch_slot_no": { "description": "Slot within the epoch", "type": "integer", "format": "int32", "nullable": true, "example": 206539 }, "time": { "description": "Block UNIX time", "type": "integer", "format": "int32", "example": 1628665630 }, "size": { "description": "Block size in bytes", "type": "integer", "format": "int32", "example": 9856 }, "tx_amount": { "description": "Transactions amount", "type": "integer", "format": "int64", "example": "1064646721545" }, "tx_out_sum": { "description": "Transactions output amount", "type": "integer", "format": "int64", "example": "1501099010264" }, "tx_fee": { "description": "Transactions fees amount", "type": "integer", "format": "int64", "example": "3592702" }, "tx": { "description": "The number of transactions", "type": "integer", "format": "int32", "example": 15 }, "pool_hash": { "description": "The hash of the slot leader or null for the Genesis slot leader", "type": "string", "nullable": true, "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, "pool_bech32": { "description": "The bech32 of the slot leader or null for the Genesis slot leader", "type": "string", "nullable": true, "example": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch" }, "pool_name": { "description": "The name of the pool that is slot leader or the description of the Genesis slot leader", "type": "string", "example": "AdaStat Pool" }, "pool_ticker": { "description": "The ticker of the pool that is slot leader or null for the Genesis slot leader", "type": "string", "nullable": true, "example": "STAT" } }, "required": [ "no", "hash", "epoch_no", "slot_no", "epoch_slot_no", "time", "size", "tx_amount", "tx_out_sum", "tx_fee", "tx", "pool_hash", "pool_bech32", "pool_name", "pool_ticker" ] }, "Tx": { "type": "object", "properties": { "hash": { "description": "Transaction hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "6b106dc610cb4aac03f9bd679027d2ff6d62ec91e1a1238342fdcca9ccf28fdb" }, "block_no": { "description": "Block number", "type": "integer", "format": "int32", "example": 8054074 }, "block_index": { "description": "Index of transaction in block", "type": "integer", "format": "int32", "example": 16 }, "block_hash": { "description": "Block hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "0736b6363ae755fd466b282bbaabc856955386ee3068ecd1b2ba7b061047a910" }, "epoch_no": { "description": "Epoch number", "type": "integer", "format": "int32", "nullable": true, "example": 377 }, "slot_no": { "description": "Slot number", "type": "integer", "format": "int32", "nullable": true, "example": 77720998 }, "epoch_slot_no": { "description": "Slot within the epoch", "type": "integer", "format": "int32", "nullable": true, "example": 220198 }, "time": { "description": "Transaction UNIX time", "type": "integer", "format": "int32", "example": 1669287289 }, "size": { "description": "Transaction size in bytes", "type": "integer", "format": "int32", "example": 766 }, "amount": { "description": "Transaction amount", "type": "integer", "format": "string", "example": "4000000" }, "out_sum": { "description": "Output amount", "type": "integer", "format": "int64", "example": "7863829780" }, "fee": { "description": "Fee amount", "type": "integer", "format": "int64", "example": "189129" }, "deposit": { "description": "Deposit amount", "type": "integer", "format": "int64", "example": "0" }, "script_size": { "description": "Script size", "type": "integer", "format": "int32", "example": 0 }, "token": { "description": "Token number in transaction", "type": "integer", "format": "int32", "example": 1 } }, "required": [ "hash", "block_no", "block_index", "block_hash", "epoch_no", "slot_no", "epoch_slot_no", "time", "size", "amount", "out_sum", "fee", "deposit", "script_size", "token" ] }, "Pool": { "type": "object", "properties": { "hash": { "description": "Pool hash", "type": "string", "format": "Hexadecimal", "minLength": 56, "maxLength": 56, "example": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, "bech32": { "description": "Pool Bech32 ID", "type": "string", "example": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch" }, "name": { "description": "The name of the pool", "type": "string", "example": "AdaStat Pool" }, "ticker": { "description": "The ticker of the pool", "type": "string", "example": "STAT" }, "valid_meta": { "description": "Valid pool metadata", "type": "boolean", "example": true }, "itn": { "description": "ITN verified ticker", "type": "boolean", "example": true }, "impersonator": { "description": "Impersonator pool", "type": "boolean", "example": false }, "active_stake": { "description": "Active pool stake", "type": "integer", "format": "int64", "example": "32227865995397" }, "live_stake": { "description": "Live pool stake", "type": "integer", "format": "int64", "example": "4912748882992" }, "owner_stake": { "description": "Live owner stake", "type": "integer", "format": "int64", "example": "4912748882992" }, "delegator": { "description": "Live delegators count", "type": "integer", "format": "int32", "example": 2345 }, "block_epoch": { "description": "Epochs with at least 1 block", "type": "integer", "format": "int32", "example": 2345 }, "total_block": { "description": "Total blocks", "type": "integer", "format": "int32", "example": 2345 }, "block": { "description": "Blocks in the current epoch", "type": "integer", "format": "int32", "example": 2345 }, "margin": { "description": "Pool margin", "type": "number", "format": "percentage ratio", "example": "0.019949" }, "fixed_cost": { "description": "Pool fixed cost", "type": "integer", "format": "int64", "example": "340000000" }, "pledge": { "description": "Declared pledge", "type": "integer", "format": "int64", "example": "200000000000" }, "reward_amount": { "description": "Total rewards distributed to delegators", "type": "integer", "format": "int64", "example": "2037234989736" }, "pool_fee": { "description": "The total amount earned by pools as pool fee (fixed fee + margin)", "type": "integer", "format": "int64", "example": "47355762063" }, "reg_time": { "description": "Registration timestamp", "type": "integer", "format": "int32", "example": 47355762063 }, "retiring_epoch": { "description": "Retiring epoch number", "type": "integer", "nullable": true, "format": "int32", "example": null }, "ros": { "description": "Pool ROS", "type": "object", "format": "key = number of epochs, 0 = all epochs, value = percentage ROS", "example": { "0": "0.0466", "1": "0.0247", "2": "0.0328", "3": "0.0353", "6": "0.0379", "12": "0.0383", "18": "0.0379", "36": "0.0390", "73": "0.0403" } } }, "required": [ "hash", "bech32", "name", "ticker", "valid_meta", "itn", "impersonator", "active_stake", "live_stake", "owner_stake", "delegator", "block_epoch", "total_block", "block", "margin", "fixed_cost", "pledge", "reward_amount", "pool_fee", "reg_time", "retiring_epoch" ] }, "Account": { "type": "object", "properties": { "hash": { "description": "Account hash", "type": "string", "format": "Hexadecimal", "minLength": 56, "maxLength": 56, "example": "d9b965d1fd70901043bed7e36d84d45852606d63d73ba1bebed6c153" }, "bech32": { "description": "Account Bech32 reward address", "type": "string", "example": "stake1u8vmjew3l4cfqyzrhmt7xmvy63v9ycrdv0tnhgd7hmtvz5c525265" }, "balance": { "description": "Live account balance", "type": "integer", "format": "int64", "example": "208775361825" }, "token": { "description": "Account token number", "type": "integer", "format": "int32", "example": 0 }, "total_reward_amount": { "description": "The total reward amount earned by account", "type": "integer", "format": "int64", "example": "17370586200" }, "first_tx_hash": { "description": "First transaction hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "ce43257d34d2282fe492ccdc00529c0142839c49da4593c3b4d753d8988f5b17" }, "first_tx_time": { "description": "First transaction time", "type": "integer", "format": "int32", "example": 1667991608 }, "last_tx_hash": { "description": "Last transaction hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "ce43257d34d2282fe492ccdc00529c0142839c49da4593c3b4d753d8988f5b17" }, "last_tx_time": { "description": "Last transaction time", "type": "integer", "format": "int32", "example": 1668091279 }, "tx": { "description": "Transaction number", "type": "integer", "format": "int32", "example": 7 }, "pool_hash": { "description": "Account pool hash", "type": "string", "format": "Hexadecimal", "minLength": 56, "maxLength": 56, "example": "77b0a93c26ac65be36e9a9f220f9a43cbc57d705fc5d8f1de5fdeea1" }, "pool_bech32": { "description": "Account pool bech32", "type": "string", "example": "pool1w7c2j0px43jmudhf48ezp7dy8j7904c9l3wc7809lhh2z026hch" }, "pool_name": { "description": "Account pool name", "type": "string", "example": "AdaStat Pool" }, "pool_ticker": { "description": "Account pool ticker", "type": "string", "example": "STAT" } }, "required": [ "hash", "bech32", "balance", "token", "total_reward_amount", "first_tx_hash", "first_tx_time", "last_tx_hash", "last_tx_time", "tx", "pool_hash", "pool_bech32", "pool_name", "pool_ticker" ] }, "Address": { "type": "object", "properties": { "address": { "description": "Address", "type": "string", "example": "Ae2tdPwUPEYwFx4dmJheyNPPYXtvHbJLeCaA96o6Y2iiUL18cAt7AizN2zG" }, "balance": { "description": "Address balance", "type": "integer", "format": "int64", "example": "700880427042149" }, "token": { "description": "Number of tokens on the address", "type": "integer", "format": "int32", "example": 6213 }, "first_tx_hash": { "description": "First transaction hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "ce43257d34d2282fe492ccdc00529c0142839c49da4593c3b4d753d8988f5b17" }, "first_tx_time": { "description": "First transaction time", "type": "integer", "format": "int32", "example": 1667991608 }, "last_tx_hash": { "description": "Last transaction hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "ce43257d34d2282fe492ccdc00529c0142839c49da4593c3b4d753d8988f5b17" }, "last_tx_time": { "description": "Last transaction time", "type": "integer", "format": "int32", "example": 1668091279 }, "tx": { "description": "Transaction number", "type": "integer", "format": "int32", "example": 7 } }, "required": [ "address", "balance", "token", "first_tx_hash", "first_tx_time", "last_tx_hash", "last_tx_time", "tx" ] }, "Token": { "type": "object", "properties": { "policy": { "description": "Policy ID", "type": "string", "format": "Hexadecimal", "minLength": 56, "maxLength": 56, "example": "fbfef0c4d74ae29cb8e2f80bb58cb2ea22d023a0f427214a9c10d0d1" }, "asset_name": { "description": "Asset name", "type": "string", "format": "ascii", "example": "TheMandrillzWorldcup95#332" }, "asset_name_hex": { "description": "Asset name hex", "type": "string", "format": "Hexadecimal", "maxLength": 64, "example": "5468654d616e6472696c6c7a576f726c64637570393523333332" }, "name": { "description": "Token name from metadata", "type": "string", "format": "ascii", "example": "TheMandrillzWorldcup #95" }, "ticker": { "description": "Token ticker from metadata", "type": "string", "format": "ascii", "example": "" }, "decimals": { "description": "Token decimals number from metadata", "type": "integer", "format": "int32", "example": 0 }, "fingerprint": { "description": "Fingerprint", "type": "string", "example": "asset1nvwnecruv7460nkprhdmvtu7nfa34f66u5zw87" }, "supply": { "description": "Total token supply", "type": "number", "example": "1" }, "first_tx_hash": { "description": "First transaction hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "ce43257d34d2282fe492ccdc00529c0142839c49da4593c3b4d753d8988f5b17" }, "first_tx_time": { "description": "First transaction time", "type": "integer", "format": "int32", "example": 1667991608 }, "last_tx_hash": { "description": "Last transaction hash", "type": "string", "format": "Hexadecimal", "minLength": 64, "maxLength": 64, "example": "ce43257d34d2282fe492ccdc00529c0142839c49da4593c3b4d753d8988f5b17" }, "last_tx_time": { "description": "Last transaction time", "type": "integer", "format": "int32", "example": 1668091279 }, "tx": { "description": "Transaction number", "type": "integer", "format": "int32", "example": 1 }, "holder": { "description": "Holders number", "type": "integer", "format": "int32", "example": 1 }, "image": { "description": "Token logo", "type": "string", "format": "URL or base64 string", "example": "ipfs://QmYe8J2jLTxYZh94DLkapKxmLyUBBvFNKC8iqKPkbYLJtP" }, "image_nonce": { "description": "Token logo nonce to prevent browser caching", "type": "string", "example": "56022949" } }, "required": [ "policy", "asset_name", "asset_name_hex", "fingerprint", "supply", "first_tx_hash", "first_tx_time", "last_tx_hash", "last_tx_time", "tx", "holder", "image", "name", "ticker", "decimals", "image_nonce" ] } } } }