{ "components": { "schemas": { "active_stake_amount": { "properties": { "amount_in_lovelaces": { "type": "integer", "format": "int64" } }, "required": [ "amount_in_lovelaces" ], "type": "object" }, "address_stake_amount": { "properties": { "stake_address": { "type": "string", "description": "stake1..." }, "amount_in_lovelaces": { "type": "integer", "format": "int64" } }, "required": [ "stake_address", "amount_in_lovelaces" ], "type": "object" }, "block": { "properties": { "number": { "type": "integer", "format": "int64" }, "epoch_number": { "type": "integer", "format": "int64" }, "slot_number": { "type": "integer", "format": "int64" }, "epoch_slot_number": { "type": "integer", "format": "int64" }, "size": { "type": "integer", "format": "int64" }, "transaction_count": { "type": "integer", "format": "int64" }, "time": { "type": "string", "format": "date-time" } }, "required": [ "number", "epoch_number", "slot_number", "epoch_slot_number", "size", "transaction_count", "time" ], "type": "object" }, "cnft_metadata_v001": { "properties": { "policyId": { "type": "string" }, "tokens": {}, "asset": { "$ref": "#/components/schemas/cnft_metadata_v001_asset" } }, "required": [ "policyId", "tokens", "asset" ], "type": "object" }, "cnft_metadata_v001_asset": { "properties": { "assetName": { "type": "string" }, "attributes": { "anyOf": [ { "type": "boolean" }, { "type": "object" }, { "type": "number" }, { "type": "integer" }, { "type": "array" }, { "type": "string" } ] }, "ipfs": { "type": "string" }, "mimeType": { "type": "string" } }, "required": [ "ipfs" ], "type": "object" }, "day_block": { "properties": { "first": { "$ref": "#/components/schemas/block" }, "last": { "$ref": "#/components/schemas/block" } }, "required": [ "first", "last" ], "type": "object" }, "delegation": { "properties": { "staking_address": { "type": "string" }, "delegations": { "items": { "$ref": "#/components/schemas/stakepool_delegation" }, "type": "array" } }, "required": [ "staking_address", "delegations" ], "type": "object" }, "delegators_count": { "properties": { "delegators_count_total": { "type": "integer" } }, "required": [ "delegators_count_total" ], "type": "object" }, "epoch": { "properties": { "out_sum": { "type": "integer", "format": "int64" }, "fees": { "type": "integer", "format": "int64" }, "tx_count": { "type": "integer" }, "blk_count": { "type": "integer" }, "number": { "type": "integer" }, "start_time": { "type": "string", "format": "date-time" }, "end_time": { "type": "string", "format": "date-time" } }, "required": [ "out_sum", "fees", "tx_count", "blk_count", "number", "start_time", "end_time" ], "type": "object" }, "generic_error": { "properties": { "description": { "type": "string" } }, "required": [ "description" ], "type": "object" }, "healthcheck": { "description": "Response for the healthcheck's endpoint of the service", "properties": { "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "native_asset": { "properties": { "transaction_id": { "type": "string" }, "policy_id": { "type": "string" }, "token_name": { "type": "string" }, "metadata": { "anyOf": [ { "type": "boolean" }, { "type": "object" }, { "type": "number" }, { "type": "integer" }, { "type": "array" }, { "type": "string" } ] }, "block_number": { "type": "integer", "format": "int64" }, "epoch_slot_number": { "type": "integer", "format": "int64" }, "epoch_number": { "type": "integer", "format": "int64" }, "invalid_before": { "type": "integer", "format": "int64" }, "invalid_hereafter": { "type": "integer", "format": "int64" }, "quantity": { "type": "integer", "format": "int64" } }, "required": [ "transaction_id", "policy_id", "token_name", "metadata", "block_number", "epoch_slot_number", "epoch_number", "quantity" ], "type": "object" }, "native_asset_details": { "properties": { "policy_id": { "type": "string" }, "asset_name": { "type": "string" }, "metadata": { "anyOf": [ { "type": "boolean" }, { "type": "object" }, { "type": "number" }, { "type": "integer" }, { "type": "array" }, { "type": "string" } ] }, "minted_at": { "type": "string", "format": "date-time" }, "last_minted_at": { "type": "string", "format": "date-time" }, "first_minting_tx_block": { "type": "integer", "format": "int64" }, "last_minting_tx_block": { "type": "integer", "format": "int64" }, "minting_tx_hash": { "type": "string" }, "circulating_supply": { "type": "integer", "format": "int64" }, "fingerprint": { "type": "string" } }, "required": [ "policy_id", "asset_name", "metadata", "minted_at", "last_minted_at", "first_minting_tx_block", "last_minting_tx_block", "minting_tx_hash", "circulating_supply", "fingerprint" ], "type": "object" }, "native_asset_details_request": { "properties": { "policy_id": { "type": "string" }, "asset_names": { "items": { "type": "string" }, "type": "array" } }, "required": [ "policy_id" ], "type": "object" }, "native_asset_id": { "properties": { "policy_id": { "type": "string" }, "asset_name": { "type": "string" }, "block_number": { "type": "integer", "format": "int64" }, "block_time": { "type": "string", "format": "date-time" }, "fingerprint": { "type": "string" } }, "required": [ "policy_id", "asset_name", "block_number", "block_time", "fingerprint" ], "type": "object" }, "nft_details": { "properties": { "policy_id": { "type": "string" }, "asset_name_raw": { "type": "string" }, "asset_name": { "type": "string" }, "metadata": { "anyOf": [ { "type": "boolean" }, { "type": "object" }, { "type": "number" }, { "type": "integer" }, { "type": "array" }, { "type": "string" } ] }, "minted_at": { "type": "string", "format": "date-time" }, "minted_at_block": { "type": "integer", "format": "int64" }, "minting_tx_hash": { "type": "string" }, "amount": { "type": "integer", "format": "int64" }, "fingerprint": { "type": "string" } }, "required": [ "policy_id", "asset_name_raw", "metadata", "minted_at", "minted_at_block", "minting_tx_hash", "amount", "fingerprint" ], "type": "object" }, "nft_metadata": { "properties": { "name": { "type": "string" }, "image": { "type": "string" }, "mediaType": { "type": "string" }, "files": { "items": { "$ref": "#/components/schemas/nft_metadata_file" }, "type": "array" } }, "type": "object" }, "nft_metadata_file": { "properties": { "name": { "type": "string" }, "src": { "type": "string" }, "mediaType": { "type": "string" } }, "type": "object" }, "nft_metadata_files_as_object": { "properties": { "name": { "type": "string" }, "image": { "type": "string" }, "mediaType": { "type": "string" }, "files": { "$ref": "#/components/schemas/nft_metadata_file" } }, "type": "object" }, "nft_metadata_img_array": { "properties": { "name": { "type": "string" }, "image": { "items": { "type": "string" }, "type": "array" }, "mediaType": { "type": "string" }, "files": { "items": { "$ref": "#/components/schemas/nft_metadata_file" }, "type": "array" } }, "type": "object" }, "nft_metadata_no_files": { "properties": { "name": { "type": "string" }, "image": { "type": "string" }, "mediaType": { "type": "string" } }, "type": "object" }, "pool_retiring": { "properties": { "ticker_name": { "type": "string" }, "pool_id": { "type": "string" }, "certificate_index": { "type": "integer" }, "epoch_number": { "type": "integer", "format": "int64" }, "block_number": { "type": "integer", "format": "int64" }, "retiring_at_epoch": { "type": "integer", "format": "int64" }, "tx_hash": { "type": "string" } }, "required": [ "pool_id", "certificate_index", "epoch_number", "block_number", "retiring_at_epoch", "tx_hash" ], "type": "object" }, "pool_update": { "properties": { "epoch_number": { "type": "integer" }, "block_number": { "type": "integer", "format": "int64" }, "tx_hash": { "type": "string" }, "pool_ticker_name": { "type": "string" }, "pool_bech32_id": { "type": "string" }, "certificate_index": { "type": "integer" }, "vrf_key_hash": { "type": "string" }, "pledge": { "type": "integer", "format": "int64" }, "reward_address": { "type": "string" }, "active_epoch_number": { "type": "integer", "format": "int64" }, "margin": { "type": "number", "format": "double" }, "fixed_cost": { "type": "integer", "format": "int64" } }, "required": [ "epoch_number", "block_number", "tx_hash", "pool_bech32_id", "certificate_index", "vrf_key_hash", "pledge", "reward_address", "active_epoch_number", "margin", "fixed_cost" ], "type": "object" }, "reward": { "properties": { "staking_address": { "type": "string" }, "epoch": { "type": "integer" }, "amount": { "type": "integer", "format": "int64" }, "pool_id": { "type": "string" } }, "required": [ "staking_address", "epoch", "amount", "pool_id" ], "type": "object" }, "sigma": { "properties": { "sigma": { "type": "number", "format": "double" }, "epoch": { "type": "integer" }, "total_staked": { "type": "integer", "format": "int64" }, "active_stake": { "type": "integer", "format": "int64" }, "nonce": { "type": "string" }, "d": { "type": "number", "format": "double" } }, "required": [ "sigma", "epoch", "total_staked", "active_stake", "nonce", "d" ], "type": "object" }, "stakepool": { "properties": { "id": { "type": "string", "description": "the id of the pool", "example": "pool1yr0cv3dtmhcfgqa6yetvmf769ngk89e6tepecmjrmjl2jzcw2lm" }, "pool_id_bech32": { "type": "string", "description": "the id in bech32 format of the pool", "example": "20df8645abddf09403ba2656cda7da2cd163973a5e439c6e43dcbea9" }, "metadata": { "$ref": "#/components/schemas/stakepool_metadata" }, "cost": { "type": "integer", "format": "int64", "description": "operational costs per epoch in lovelaces" }, "margin": { "type": "number", "format": "double", "description": "operator margin, percentage (from 0 to 1)" }, "pledge": { "type": "integer", "format": "int64", "description": "pledge amount, in lovelaces" }, "active_stake": { "type": "integer", "format": "int64", "description": "active stake for current epoch in lovelaces" }, "saturation": { "type": "number", "format": "double", "description": "pool saturation as percentage (0 to 1)" }, "retiring_at_epoch": { "type": "integer", "format": "int64", "description": "if defined, is the epoch at which the pool will retire" } }, "required": [ "id", "pool_id_bech32", "cost", "margin", "pledge", "active_stake", "saturation" ], "type": "object" }, "stakepool_delegation": { "properties": { "stakepool": { "$ref": "#/components/schemas/stakepool" }, "epoch": { "type": "integer" } }, "required": [ "stakepool", "epoch" ], "type": "object" }, "stakepool_metadata": { "description": "Stake Pool Offline Metadata", "properties": { "name": { "type": "string" }, "ticker": { "type": "string" }, "homepage": { "type": "string" }, "description": { "type": "string" }, "extended": { "type": "string" } }, "required": [ "name", "ticker", "homepage", "description" ], "type": "object" }, "transaction": { "properties": { "hash": { "type": "string" }, "block": { "type": "integer", "format": "int64" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "hash", "block", "timestamp" ], "type": "object" }, "transaction_history_request": { "properties": { "addresses": { "items": { "type": "string" }, "type": "array" } }, "required": [ "addresses" ], "type": "object" }, "wallet_balance": { "properties": { "balance": { "type": "integer", "format": "int64" } }, "required": [ "balance" ], "type": "object" }, "country": { "description": "Possible values: IE,UK.", "enum": [ "IE", "UK" ], "type": "string" } } }, "info": { "contact": {}, "license": {}, "termsOfService": "", "title": "hilltop-api", "version": "0.0.1-SNAPSHOT" }, "openapi": "3.0.2", "paths": { "/active_stake_amounts": { "get": { "operationId": "get--active_stake_amounts", "parameters": [ { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer" }, "name": "epoch_number" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.active_stake_amount", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/active_stake_amount" } } }, "headers": {} } }, "tags": [ "active_stake_amount" ] } }, "/active_stake_amounts/:pool_bech32_id": { "get": { "operationId": "get--active_stake_amounts-pool_bech_id", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "pool_bech32_id" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer" }, "name": "epoch_number" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.active_stake_amount", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/active_stake_amount" } } }, "headers": {} } }, "tags": [ "active_stake_amount" ] } }, "/active_stake_amounts/:pool_bech32_id/addresses": { "get": { "operationId": "get--active_stake_amounts-pool_bech_id-addresses", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "pool_bech32_id" }, { "deprecated": false, "in": "query", "required": true, "schema": { "type": "integer" }, "name": "epoch_number" } ], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.address_stake_amount]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/address_stake_amount" }, "type": "array" } } }, "headers": {} } }, "tags": [ "active_stake_amount" ] } }, "/blocks/blocks_in_day": { "get": { "operationId": "get--blocks-blocks_in_day", "parameters": [ { "deprecated": false, "in": "query", "required": true, "schema": { "type": "string", "format": "date" }, "name": "date" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.day_block", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/day_block" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "block" ] } }, "/blocks/:block_number": { "get": { "operationId": "get--blocks-block_number", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" }, "description": "the block number", "name": "block_number" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.block", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/block" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "block" ] } }, "/delegations/:staking_address/safe_payment": { "get": { "operationId": "get--delegations-staking_address-safe_payment", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "staking_address" } ], "responses": { "200": { "description": "string", "content": { "application/json": { "schema": { "type": "string" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "delegation" ] } }, "/delegations/:staking_address/stakepool": { "get": { "operationId": "get--delegations-staking_address-stakepool", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "staking_address" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.delegation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/delegation" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "delegation" ] } }, "/delegators_counts/:pool_bech32_id": { "get": { "operationId": "get--delegators_counts-pool_bech_id", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "pool_bech32_id" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.delegators_count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/delegators_count" } } }, "headers": {} } }, "tags": [ "delegators_count" ] } }, "/epochs/current": { "get": { "operationId": "get--epochs-current", "parameters": [], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.epoch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/epoch" } } }, "headers": {} } }, "tags": [ "epoch" ] } }, "/epochs/:epoch_number": { "get": { "operationId": "get--epochs-epoch_number", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "integer" }, "name": "epoch_number" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.epoch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/epoch" } } }, "headers": {} } }, "tags": [ "epoch" ] } }, "/healthchecks": { "get": { "operationId": "get--healthchecks", "parameters": [], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.healthcheck", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/healthcheck" } } }, "headers": {} } }, "tags": [ "healthcheck" ] } }, "/native_assets/ids": { "get": { "operationId": "get--native_assets-ids", "parameters": [ { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" }, "description": "the block number from when fetching updates, it's the pagination index", "name": "block_number_from" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" }, "description": "the number of updates to fetch", "name": "limit" } ], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.native_asset_id]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/native_asset_id" }, "type": "array" } } }, "headers": {} } }, "tags": [ "native_asset" ] } }, "/native_assets/:policy_id/asset_names": { "get": { "operationId": "get--native_assets-policy_id-asset_names", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "description": "the policy id to get the asset name", "name": "policy_id" } ], "responses": { "200": { "description": "[string]", "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array" } } }, "headers": {} } }, "tags": [ "native_asset" ] } }, "/native_assets/nfts": { "get": { "operationId": "get--native_assets-nfts", "parameters": [ { "deprecated": false, "in": "query", "required": true, "schema": { "type": "integer", "format": "int64" }, "name": "block_number_from" }, { "deprecated": false, "in": "query", "required": true, "schema": { "type": "integer", "format": "int64" }, "name": "block_number_to" } ], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.nft_details]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/nft_details" }, "type": "array" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "native_asset" ] } }, "/native_assets/native_assets_details": { "post": { "operationId": "post--native_assets-native_assets_details", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/native_asset_details_request" } } } }, "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.native_asset_details]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/native_asset_details" }, "type": "array" } } }, "headers": {} } }, "tags": [ "native_asset" ] } }, "/native_assets/:stake_address": { "get": { "operationId": "get--native_assets-stake_address", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "stake_address" } ], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.native_asset]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/native_asset" }, "type": "array" } } }, "headers": {} } }, "tags": [ "native_asset" ] } }, "/pool_updates/retiring": { "get": { "operationId": "get--pool_updates-retiring", "parameters": [ { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" }, "description": "the block number from when fetching updates, it's the pagination index", "name": "block_number_from" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" }, "description": "the number of updates to fetch", "name": "limit" } ], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.pool_retiring]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/pool_retiring" }, "type": "array" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "pool_update" ] } }, "/pool_updates/:pool_id": { "get": { "operationId": "get--pool_updates-pool_id", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "pool_id" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" }, "description": "the block number from when fetching updates, it's the pagination index", "name": "block_number_from" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" }, "description": "the number of updates to fetch", "name": "limit" } ], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.pool_update]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/pool_update" }, "type": "array" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "pool_update" ] } }, "/pool_updates": { "get": { "operationId": "get--pool_updates", "parameters": [ { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" }, "description": "the block number from when fetching updates, it's the pagination index", "name": "block_number_from" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" }, "description": "the number of updates to fetch", "name": "limit" } ], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.pool_update]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/pool_update" }, "type": "array" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "pool_update" ] } }, "/rewards/:staking_address": { "get": { "operationId": "get--rewards-staking_address", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "staking_address" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer" }, "name": "epoch_from" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer" }, "name": "epoch_to" } ], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.reward]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/reward" }, "type": "array" } } }, "headers": {} } }, "tags": [ "reward" ] } }, "/sigmas/:pool_id": { "get": { "description": "can be either the pool_id (e.g. pool1wcwe923r...) or the pool_hash", "operationId": "get--sigmas-pool_id", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "pool_id" }, { "deprecated": false, "in": "query", "required": true, "schema": { "type": "integer" }, "name": "epoch_number" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.sigma", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sigma" } } }, "headers": {} } }, "tags": [ "sigma" ] } }, "/stakepools/vrf_vkey/:vrf_vkey_hash": { "get": { "description": "find pool details by vrf_vkey", "operationId": "get--stakepools-vrf_vkey-vrf_vkey_hash", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "description": "the hash of the vrf_vkey", "name": "vrf_vkey_hash" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.stakepool", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/stakepool" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "stakepool" ] } }, "/stakepools/:pool_id/established_epoch": { "get": { "description": "Epoch at which stake pool was originally registered", "operationId": "get--stakepools-pool_id-established_epoch", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "description": "id of the pool to query. Both id and bech32 formats are supported", "name": "pool_id" } ], "responses": { "200": { "description": "integer", "content": { "application/json": { "schema": { "type": "integer" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "stakepool" ] } }, "/stakepools/:pool_id/live_stake": { "get": { "description": "live stake in lovelaces", "operationId": "get--stakepools-pool_id-live_stake", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "description": "id of the pool to query. Both id and bech32 formats are supported", "name": "pool_id" } ], "responses": { "200": { "description": "long", "content": { "application/json": { "schema": { "type": "integer", "format": "int64" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "stakepool" ] } }, "/stakepools/:pool_id/blocks": { "get": { "description": "number minted blocks in epoch", "operationId": "get--stakepools-pool_id-blocks", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "description": "id of the pool to query. Both id and bech32 formats are supported", "name": "pool_id" }, { "deprecated": false, "in": "query", "required": false, "schema": { "type": "integer" }, "description": "epoch in which to query number of produced blocks or current epoch if not specified", "name": "epoch" } ], "responses": { "200": { "description": "integer", "content": { "application/json": { "schema": { "type": "integer" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "stakepool" ] } }, "/stakepools": { "get": { "operationId": "get--stakepools", "parameters": [], "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.stakepool]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/stakepool" }, "type": "array" } } }, "headers": {} } }, "tags": [ "stakepool" ] } }, "/stakepool_metadata/:pool_id_bech32": { "get": { "operationId": "get--stakepool_metadata-pool_id_bech", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "pool_id_bech32" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.stakepool_metadata", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/stakepool_metadata" } } }, "headers": {} }, "404": { "description": "io.gimbalabs.hilltop.api.v0.models.generic_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/generic_error" } } }, "headers": {} } }, "tags": [ "stakepool_metadata" ] } }, "/transactions/history": { "post": { "operationId": "post--transactions-history", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/transaction_history_request" } } } }, "responses": { "200": { "description": "[io.gimbalabs.hilltop.api.v0.models.transaction]", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/transaction" }, "type": "array" } } }, "headers": {} } }, "tags": [ "transaction" ] } }, "/wallet_balances/:staking_address": { "get": { "operationId": "get--wallet_balances-staking_address", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "staking_address" } ], "responses": { "200": { "description": "io.gimbalabs.hilltop.api.v0.models.wallet_balance", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/wallet_balance" } } }, "headers": {} } }, "tags": [ "wallet_balance" ] } } }, "servers": [ { "url": "https://hilltop-api.mainnet.dandelion.link" } ] }