--- updatedAt: 2026-06-02T20:06:00.000Z agentTools: projectIndex: https://docs.zerohash.com/llms.txt --- # Get asset staking information Returns staking parameters for a specific asset including APY, activation periods, and unstaking details. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "zerohash API", "description": "\n### Authentication\n\nzerohash Uses HMAC SHA-256 verification to ensure the authenticity of API requests, follow instructions by link [https://docs.zerohash.com/reference/api-authentication](https://docs.zerohash.com/reference/api-authentication)\n\nDownload zerohash OpenAPI Schema as JSON\n", "version": "1.7.0" }, "servers": [ { "url": "https://api.cert.zerohash.com", "description": "Certification API server" } ], "x-readme": { "proxy-enabled": false }, "tags": [ { "name": "Assets", "description": "View available assets" } ], "paths": { "/assets/{asset}/staking_info": { "get": { "tags": [ "Assets" ], "summary": "Get asset staking information", "description": "Returns staking parameters for a specific asset including APY, activation periods, and unstaking details.", "parameters": [ { "$ref": "#/components/parameters/Signature" }, { "$ref": "#/components/parameters/Timestamp" }, { "name": "asset", "in": "path", "description": "Asset symbol (e.g., ETH, BTC, SOL)", "required": true, "schema": { "type": "string", "pattern": "^[A-Z0-9]+$", "example": "ETH" } } ], "responses": { "200": { "description": "Staking information retrieved successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAssetStakingInfoResponse" } } } }, "400": { "description": "The asset is not registered or is disabled for staking.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StakingValidationErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code403" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code404" } } } }, "500": { "description": "Staking information is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StakingValidationErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code503" } } } } } } } }, "security": [ { "apiKey": [], "apiPassphrase": [] } ], "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "description": "Your API public key. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for how to obtain keys.", "in": "header", "name": "X-SCX-API-KEY" }, "apiPassphrase": { "type": "apiKey", "description": "The passphrase associated with your API key, set when the key was created.", "in": "header", "name": "X-SCX-PASSPHRASE" } }, "parameters": { "Signature": { "name": "X-SCX-SIGNED", "in": "header", "description": "HMAC-SHA256 signature of the request, base64-encoded. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for the exact signing formula.", "required": true, "schema": { "type": "string" } }, "Timestamp": { "name": "X-SCX-TIMESTAMP", "in": "header", "description": "Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.", "required": true, "schema": { "type": "string", "example": "1678901234" } } }, "schemas": { "Code403": { "type": "object", "description": "Authentication or authorization failed. `error` is always `true`; `message` explains which check failed (missing API key, bad signature, insufficient permission, etc.).", "required": [ "error", "message" ], "properties": { "error": { "type": "boolean", "example": true }, "message": { "type": "string", "example": "This api key does not have write permission to this endpoint" } } }, "Code404": { "type": "object", "description": "The requested resource does not exist or is not visible to the caller.", "required": [ "error" ], "properties": { "error": { "type": "string", "example": "Not Found" } } }, "Code503": { "type": "object", "description": "A downstream dependency was unavailable, timed out, or returned a retryable error. Safe to retry; the response carries a `zh-allow-retry: true` header.", "required": [ "error" ], "properties": { "error": { "type": "string", "example": "Service Unavailable" } } }, "StakingValidationErrorResponse": { "type": "object", "properties": { "error_code": { "type": "string", "description": "Error code", "example": "VALIDATION_FAILED" }, "message": { "type": "string", "description": "Error message", "example": "Staking validation failed" }, "details": { "type": "object", "properties": { "participant_code": { "type": "string", "example": "XXXXXX" }, "stake_id": { "type": "string", "example": "c761fc96-5c44-40d4-8eb2-3fcd5d06754e" }, "asset": { "type": "string", "example": "ETH" }, "validation_checks": { "type": "object", "properties": { "jurisdiction_allowed": { "type": "boolean", "example": true }, "terms_accepted": { "type": "boolean", "example": false }, "platform_restrictions": { "type": "string", "example": "none" }, "sufficient_balance": { "type": "boolean", "example": true } } } } }, "user_message": { "type": "string", "description": "User-friendly error message", "example": "Please accept terms and conditions to proceed" }, "request_id": { "type": "string", "format": "uuid", "description": "Request identifier, echoes the X-Request-Id request header", "example": "8bb7e203-13e0-4208-80bc-e9fdb7faa13e" }, "timestamp": { "type": "string", "format": "date-time", "description": "Timestamp when the error occurred", "example": "2026-09-22T16:00:00Z" } } }, "StakeableAssetInfoEntity": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Asset symbol", "example": "ETH" }, "apy_net": { "type": "string", "description": "Annual percentage yield net of fees", "example": "3.47" }, "activation_period_days": { "type": "integer", "deprecated": true, "description": "Number of days until stake becomes active. Deprecated: will be replaced by `estimated_active_at`, the estimated activation time for a stake submitted now.", "example": 2 }, "payout_frequency": { "type": "string", "description": "Frequency of reward payouts", "example": "daily" }, "unstaking_period_days": { "type": "integer", "deprecated": true, "description": "Number of days for unstaking cooldown period. Deprecated: will be replaced by `estimated_available_at`, the estimated availability time for an unstake submitted now.", "example": 8 } } }, "GetAssetStakingInfoResponse": { "type": "object", "properties": { "request_id": { "type": "string", "description": "Request identifier", "example": "8bb7e203-13e0-4208-80bc-e9fdb7faa13e" }, "message": { "type": "object", "properties": { "stakeable_assets": { "type": "array", "items": { "$ref": "#/components/schemas/StakeableAssetInfoEntity" }, "description": "List of stakeable assets with their information" }, "last_updated": { "type": "string", "format": "date-time", "description": "Timestamp when staking info was last updated", "example": "2025-08-24T15:30:00Z" } } } } } } } } ```