{ "openapi": "3.0.3", "servers": [ { "url": "https://rest.vaultody.com", "description": "REST API" } ], "components": { "securitySchemes": { "ApiKey": { "name": "x-api-key", "description": "cb233681a8ee35665296c1824c1f67bc46691788", "type": "apiKey", "in": "header" }, "ApiSign": { "name": "x-api-sign", "description": "PSqeqRLap8rBc/wogNU1DeGGUPb2VyVtg6GiBOaBnYQ=", "type": "apiKey", "in": "header" }, "ApiTimestamp": { "name": "x-api-timestamp", "description": "1681885776", "type": "apiKey", "in": "header" }, "ApiPassphrase": { "name": "x-api-passphrase", "description": "zYgKeueoOq", "type": "apiKey", "in": "header" } }, "schemas": { "GenerateDepositAddressRB": { "type": "object", "properties": { "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "type": "object", "properties": { "label": { "type": "string", "description": "Represents a custom tag that customers can set up for their Wallets and addresses. E.g. custom label named \"Special addresses\".", "example": "yourLabelStringHere" } }, "required": [ "label" ] } }, "required": [ "item" ] } }, "required": [ "data" ] }, "CreateCoinsTransactionRequestFromVaultRB": { "type": "object", "properties": { "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "type": "object", "properties": { "feePriority": { "type": "string", "description": "Represents the fee priority of the automation, whether it is \"slow\", \"standard\" or \"fast\".", "example": "standard", "enum": [ "slow", "standard", "fast" ] }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "prepareStrategy": { "type": "string", "description": "Refers to a model of a UTXO spending strategy, where customers can choose how to spend their transaction outputs from multiple Bitcoin addresses. Two options available - \"minimize-dust\" (select lower amounts from multiple addresses) or \"optimize-size\" (select higher amounts from less addresses).", "example": "minimize-dust", "default": "minimize-dust", "enum": [ "minimize-dust", "optimize-size" ] }, "recipients": { "type": "array", "description": "Defines the destination of the transaction, whether it is incoming or outgoing.", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Defines the specific recipient/destination address.", "example": "2MtzNEqm2D9jcbPJ5mW7Z3AUNwqt3afZH66" }, "amount": { "type": "string", "description": "Represents the specific amount of the transaction's destination.", "example": "0.125" } }, "required": [ "address", "amount" ] } } }, "required": [ "feePriority", "recipients" ] } }, "required": [ "item" ] } }, "required": [ "data" ] }, "CreateCoinsTransactionRequestFromAddressRB": { "type": "object", "properties": { "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "type": "object", "properties": { "amount": { "type": "string", "description": "Represents the specific amount of the transaction.", "example": "0.2" }, "feePriority": { "type": "string", "description": "Represents the fee priority of the automation, whether it is \"slow\", \"standard\" or \"fast\".", "example": "slow", "enum": [ "slow", "standard", "fast" ] }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipientAddress": { "type": "string", "description": "Defines the specific recipient address for the transaction. For XRP we also support the X-address format.", "example": "0xc6d46aba0c6e2eb6358c4e24804158cc4d847922" } }, "required": [ "amount", "feePriority", "recipientAddress" ] } }, "required": [ "item" ] } }, "required": [ "data" ] }, "CreateCoinsTransactionFromAddressForWholeAmountRB": { "type": "object", "properties": { "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "type": "object", "properties": { "feePriority": { "type": "string", "description": "Represents the fee priority of the automation, whether it is \"slow\", \"standard\" or \"fast\".", "example": "standard", "enum": [ "slow", "standard", "fast" ] }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipientAddress": { "type": "string", "description": "Defines the specific recipient address for the transaction.", "example": "0xc6d46aba0c6e2eb6358c4e24804158cc4d847922" } }, "required": [ "feePriority", "recipientAddress" ] } }, "required": [ "item" ] } }, "required": [ "data" ] }, "CreateFungibleTokensTransactionRequestFromAddressRB": { "type": "object", "properties": { "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "type": "object", "properties": { "amount": { "type": "string", "description": "Represents the specific amount of the transaction.", "example": "0.2" }, "feePriority": { "type": "string", "description": "Represents the fee priority of the automation, whether it is \"slow\", \"standard\" or \"fast\".", "example": "standard", "enum": [ "slow", "standard", "fast" ] }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipientAddress": { "type": "string", "description": "Defines the specific recipient address for the transaction.", "example": "0xc6d46aba0c6e2eb6358c4e24804158cc4d847922" }, "tokenIdentifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the `propertyId` and for Ethereum-based transactions - the `contract`.", "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" } }, "required": [ "amount", "feePriority", "recipientAddress", "tokenIdentifier" ] } }, "required": [ "item" ] } }, "required": [ "data" ] }, "CreateFungibleTokensTransactionRequestFromAddressRISE": { "type": "object", "properties": { "contractAddress": { "type": "string", "description": "Defines the contract address in the blockchain for an ERC20 token.", "example": "0x534bD102153EF199abAe8296a2FaE4599fC44Cdc" } }, "description": "Ethereum Erc20 Token", "required": [ "contractAddress" ] }, "CreateFungibleTokensTransactionRequestFromAddressRIS": { "type": "object", "description": "Represents the specific token data which depends on its type - if it is a Coin or Token.", "oneOf": [ { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressRISE" } ] }, "CreateSingleTransactionRequestFromAddressWithoutFeePriorityRB": { "type": "object", "properties": { "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "type": "object", "properties": { "amount": { "type": "string", "description": "Represents the specific amount of the transaction's destination.", "example": "0.0006" }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipientAddress": { "type": "string", "description": "Defines the specific recipient/destination address.", "example": "TMVeigwYyuXJVHER4oA2yQzsFFSN2JfXkt" } }, "required": [ "amount", "recipientAddress" ] } }, "required": [ "item" ] } }, "required": [ "data" ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityRB": { "type": "object", "properties": { "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "type": "object", "properties": { "amount": { "type": "string", "description": "Represents the specific amount of the transaction.", "example": "0.25684" }, "feeLimit": { "type": "string", "description": "Fee limit of the smart contract. If \"OUT_OF_ENERGY\" error appears - It is necessary to check whether the address of the calling contract has TRX and whether it is enough to pay for the burning energy or bandwidth cost, otherwise the address needs to obtain enough TRX. If there is enough TRX, the feeLimit set by the transaction is smaller, and it needs to be increased.", "example": "1000000000" }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipientAddress": { "type": "string", "description": "Defines the specific recipient address for the transaction.", "example": "TMVeigwYyuXJVHER4oA2yQzsFFSN2JfXkt" }, "tokenIdentifier": { "type": "string", "description": "Token identifier - for BITCOIN BASED should be property id e.g 31 for ETHEREUM BASED shoud be contract e.g 0xdac17f958d2ee523a2206206994597c13d831ec7", "example": "TF17BgPaZYbz8oxbjhriubPDsA7ArKoLX3" } }, "required": [ "amount", "recipientAddress", "tokenIdentifier" ] } }, "required": [ "item" ] } }, "required": [ "data" ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityRIST": { "type": "object", "properties": { "contractAddress": { "type": "string", "description": "Defines the contract address in the blockchain for an ERC20 token.", "example": "TF17BgPaZYbz8oxbjhriubPDsA7ArKoLX3" }, "feeLimit": { "type": "string", "description": "Defines the fee limit value.", "example": "1000000000" }, "symbol": { "type": "string", "description": "Defines the Token symbol.", "example": "JST" } }, "description": "Tron Trc20 Token", "required": [ "contractAddress", "feeLimit", "symbol" ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityRIS": { "type": "object", "description": "Represents the specific token data which depends on its type - if it is a Coin or Token.", "oneOf": [ { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityRIST" } ] }, "ValidateAddressRB": { "type": "object", "properties": { "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "type": "object", "properties": { "address": { "type": "string", "description": "Represents the specific address that will be checked if it's valid or not.", "example": "mho4jHBcrNCncKt38trJahXakuaBnS7LK5" } }, "required": [ "address" ] } }, "required": [ "item" ] } }, "required": [ "data" ] }, "GenerateDepositAddressRI": { "type": "object", "properties": { "address": { "type": "string", "description": "Specifies the specific address's unique string value.", "example": "2MtzNEqm2D9jcbPJ5mW7Z3AUNwqt3afZH66" }, "createdTimestamp": { "type": "integer", "description": "Defines the specific UNIX time when the deposit address was created.", "example": 1624028267 }, "label": { "type": "string", "description": "Represents a custom tag that customers can set up for their Wallets and addresses. E.g. custom label named \"Special addresses\".", "example": "yourLabelStringHere" } }, "required": [ "address", "createdTimestamp", "label" ] }, "GenerateDepositAddressR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/GenerateDepositAddressRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "BannedIpAddress": { "type": "object", "description": "banned_ip_address", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "banned_ip_address" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "This IP address has been banned. To check the reason for that, please contact our team via email." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "UriNotFound": { "type": "object", "description": "uri_not_found", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "uri_not_found" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The specified URI has not been found. Check the URI and try again." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "UnexpectedServerError": { "type": "object", "description": "unexpected_server_error", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "unexpected_server_error" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "MissingApiKey": { "type": "object", "description": "missing_api_key", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "missing_api_key" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The specific authorization header (API Key) is missing, please check our Authorization section in our Documentation." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "UnsupportedMediaType": { "type": "object", "description": "unsupported_media_type", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "unsupported_media_type" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "RequestLimitReached": { "type": "object", "description": "request_limit_reached", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "request_limit_reached" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "InvalidApiKey": { "type": "object", "description": "invalid_api_key", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "invalid_api_key" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The provided API key is invalid. Please, generate a new one from your Dashboard." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "GenerateDepositAddressE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "InsufficientCredits": { "type": "object", "description": "insufficient_credits", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "insufficient_credits" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "InvalidData": { "type": "object", "description": "invalid_data", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "invalid_data" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The data provided seems to be invalid." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "LimitGreaterThanAllowed": { "type": "object", "description": "limit_greater_than_allowed", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "limit_greater_than_allowed" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "You have reached the allowed limit. The maximum number of items for this endpoint is {limit}, please use the specific pagination attributes to get the items in portions." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "GenerateDepositAddressE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "InvalidPagination": { "type": "object", "description": "invalid_pagination", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "invalid_pagination" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The pagination attributes that have been used are invalid. Please check the Documentation to see details on pagination." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "EndpointNotAllowedForPlan": { "type": "object", "description": "endpoint_not_allowed_for_plan", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "endpoint_not_allowed_for_plan" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "This endpoint is not available for your current subscription plan, please upgrade your plan to be able to use it." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "GenerateDepositAddressE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceDepositAddressesLimitReached" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "EndpointNotAllowedForApiKey": { "type": "object", "description": "endpoint_not_allowed_for_api_key", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "endpoint_not_allowed_for_api_key" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "This endpoint is not available for your API key." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "FeatureMainnetsNotAllowedForPlan": { "type": "object", "description": "feature_mainnets_not_allowed_for_plan", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "feature_mainnets_not_allowed_for_plan" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "Mainnets access is not available for your current subscription plan, please upgrade your plan to be able to use it." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "InvalidRequestBodyStructure": { "type": "object", "description": "invalid_request_body_structure", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "invalid_request_body_structure" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }" }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "ResourceNotFound": { "type": "object", "description": "resource_not_found", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "resource_not_found" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The specified resource has not been found." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "WalletAsAServiceDepositAddressesLimitReached": { "type": "object", "description": "wallet_as_a_service_deposit_addresses_limit_reached", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "wallet_as_a_service_deposit_addresses_limit_reached" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "You have reached the maximum Deposit Addresses count which is currently {depositAddressesCount}. Please, upgrade your plan in order to have a higher Deposit Address count." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType": { "type": "object", "description": "wallet_as_a_service_provided_network_is_not_suitable_for_this_wallet_type", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "wallet_as_a_service_provided_network_is_not_suitable_for_this_wallet_type" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "This wallet is not for the provided network." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "CreateCoinsTransactionRequestFromVaultRI": { "type": "object", "properties": { "feePriority": { "type": "string", "description": "Represents the fee priority of the automation, whether it is \"slow\", \"standard\" or \"fast\".", "example": "standard", "enum": [ "slow", "standard", "fast" ] }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipients": { "type": "array", "description": "Defines the destination of the transaction, whether it is incoming or outgoing.", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Defines the specific destination address.", "example": "mmd963W1fECjLyaDCHcioSCZYHkRwjkhtr" }, "amount": { "type": "string", "description": "Represents the specific amount of the transaction's destination.", "example": "0.00123" } }, "required": [ "address", "amount" ] } }, "totalTransactionAmount": { "type": "string", "description": "Represents the specific amount of the transaction.", "example": "0.001" }, "transactionRequestId": { "type": "string", "description": "Represents a unique identifier of the transaction request (the request sent to make a transaction), which helps in identifying which callback and which `referenceId` concern that specific transaction request.", "example": "6017dd02a309213863be9e55" }, "transactionRequestStatus": { "type": "string", "description": "Defines the status of the transaction, e.g. \"created, \"await_approval\", \"pending\", \"prepared\", \"signed\", \"broadcasted\", \"success\", \"failed\", \"rejected\", mined\".", "example": "created", "enum": [ "created", "await-approval", "pending", "prepared", "signed", "broadcasted", "success", "failed", "rejected", "mined" ] } }, "required": [ "feePriority", "recipients", "totalTransactionAmount", "transactionRequestId", "transactionRequestStatus" ] }, "CreateCoinsTransactionRequestFromVaultR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromVaultRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "CreateCoinsTransactionRequestFromVaultE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "CreateCoinsTransactionRequestFromVaultE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "CreateCoinsTransactionRequestFromVaultE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "WalletAsAServiceWalletBalanceNotEnough": { "type": "object", "description": "wallet_as_a_service_wallet_balance_not_enough", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "wallet_as_a_service_wallet_balance_not_enough" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "Your wallet balance is insufficient to complete this action. Please check for any pending transaction requests or add more funds." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "CreateCoinsTransactionRequestFromVaultE409": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/InvalidData" }, { "$ref": "#/components/schemas/WalletAsAServiceWalletBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceAddressBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceNoDepositAddressesFound" } ] }, "WalletAsAServiceAddressBalanceNotEnough": { "type": "object", "description": "wallet_as_a_service_address_balance_not_enough", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "wallet_as_a_service_address_balance_not_enough" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "Your address balance is insufficient to complete this action. Please check for any pending transaction requests or add more funds." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "WalletAsAServiceNoDepositAddressesFound": { "type": "object", "description": "wallet_as_a_service_no_deposit_addresses_found", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "wallet_as_a_service_no_deposit_addresses_found" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "Please first create a deposit address for the specific blockchain and network, in order to be able to make transactions." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "CreateCoinsTransactionRequestFromAddressRI": { "type": "object", "properties": { "addressTag": { "type": "integer", "description": "Defines a specific Tag that is an additional XRP address feature. It helps identify a transaction recipient beyond a wallet address. The tag that was encoded into the x-Address along with the Source Classic Address.", "example": 3999472835 }, "classicAddress": { "type": "string", "description": "Represents the public address, which is a compressed and shortened form of a public key. The classic address is shown when the source address is an x-Address.", "example": "rA9bXGJcXvZKaWofrRphdJsBWzhyCfH3z" }, "feePriority": { "type": "string", "description": "Represents the fee priority of the automation, whether it is \"slow\", \"standard\" or \"fast\".", "example": "standard", "enum": [ "slow", "standard", "fast" ] }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipients": { "type": "array", "description": "Defines the destination for the transaction, i.e. the recipient(s).", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Defines the destination address.", "example": "0xc6d46aba0c6e2eb6358c4e24804158cc4d847922" }, "addressTag": { "type": "integer", "description": "Defines a specific Tag that is an additional XRP address feature. It helps identify a transaction recipient beyond a wallet address. The tag that was encoded into the x-Address along with the Source Classic Address.", "example": 3999472835 }, "amount": { "type": "string", "description": "Defines the amount sent to the destination address.", "example": "0.0023" }, "classicAddress": { "type": "string", "description": "Represents the public address, which is a compressed and shortened form of a public key. The classic address is shown when the source address is an x-Address.", "example": "rA9bXGJcXvZKaWofrRphdJsBWzhyCfH3z" } }, "required": [ "address", "amount" ] } }, "senders": { "type": "object", "description": "Defines details about the source, i.e. the sender.", "properties": { "address": { "type": "string", "description": "Defines the sender's public address.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" } }, "required": [ "address" ] }, "transactionRequestId": { "type": "string", "description": "Represents a unique identifier of the transaction request (the request sent to make a transaction), which helps in identifying which callback and which `referenceId` concern that specific transaction request.", "example": "6017dd02a309213863be9e55" }, "transactionRequestStatus": { "type": "string", "description": "Defines the status of the transaction request, e.g. \"created, \"await_approval\", \"pending\", \"prepared\", \"signed\", \"broadcasted\", \"success\", \"failed\", \"rejected\", mined\".", "example": "created", "enum": [ "created", "await-approval", "pending", "prepared", "signed", "broadcasted", "success", "failed", "rejected", "mined" ] } }, "required": [ "feePriority", "recipients", "senders", "transactionRequestId", "transactionRequestStatus" ] }, "CreateCoinsTransactionRequestFromAddressR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromAddressRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "CreateCoinsTransactionRequestFromAddressE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "CreateCoinsTransactionRequestFromAddressE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "CreateCoinsTransactionRequestFromAddressE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "CreateCoinsTransactionRequestFromAddressE409": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/InvalidData" }, { "$ref": "#/components/schemas/WalletAsAServiceWalletBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceAddressBalanceNotEnough" } ] }, "CreateCoinsTransactionFromAddressForWholeAmountRI": { "type": "object", "properties": { "feePriority": { "type": "string", "description": "Represents the fee priority of the automation, whether it is \"slow\", \"standard\" or \"fast\".", "example": "standard", "enum": [ "slow", "standard", "fast" ] }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.Optional Transaction note with additional details", "example": "yourExampleStringHere" }, "recipients": { "type": "array", "description": "Defines the destination for the transaction, i.e. the recipient(s).", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Defines the destination address.", "example": "0xc065b539490f81b6c297c37b1925c3be2f190732" }, "amount": { "type": "string", "description": "Defines the amount sent to the destination address.", "example": "0.123" } }, "required": [ "address", "amount" ] } }, "senders": { "type": "object", "description": "Details about the sender", "properties": { "address": { "type": "string", "description": "Defines the sender's public address.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" } }, "required": [ "address" ] }, "transactionRequestId": { "type": "string", "description": "Represents a unique identifier of the transaction request (the request sent to make a transaction), which helps in identifying which callback and which `referenceId` concern that specific transaction request.", "example": "6017dd02a309213863be9e55" }, "transactionRequestStatus": { "type": "string", "description": "Defines the status of the transaction, e.g. \"created, \"await_approval\", \"pending\", \"prepared\", \"signed\", \"broadcasted\", \"success\", \"failed\", \"rejected\", mined\".", "example": "created", "enum": [ "created", "await-approval", "pending", "prepared", "signed", "broadcasted", "success", "failed", "rejected", "mined" ] } }, "required": [ "feePriority", "recipients", "senders", "transactionRequestId", "transactionRequestStatus" ] }, "CreateCoinsTransactionFromAddressForWholeAmountR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/CreateCoinsTransactionFromAddressForWholeAmountRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "CreateCoinsTransactionFromAddressForWholeAmountE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "CreateCoinsTransactionFromAddressForWholeAmountE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "CreateCoinsTransactionFromAddressForWholeAmountE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "CreateCoinsTransactionFromAddressForWholeAmountE409": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/InvalidData" }, { "$ref": "#/components/schemas/WalletAsAServiceWalletBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceAddressBalanceNotEnough" } ] }, "ListDepositAddressesRI": { "type": "object", "properties": { "address": { "type": "string", "description": "Specifies the specific address's unique string value.", "example": "0xe2b5f5e885a268e4b6faae53f99a663f3bb3e036" }, "confirmedBalance": { "type": "object", "properties": { "amount": { "type": "string", "description": "Defines the total balance of the address that is confirmed. It doesn't include unconfirmed transactions.", "example": "0.0101" }, "unit": { "type": "string", "description": "Represents the unit of the confirmed balance.", "example": "BTC" } }, "required": [ "amount", "unit" ] }, "createdTimestamp": { "type": "integer", "description": "Defines the specific UNIX time when the deposit address was created.", "example": 346658753 }, "fungibleTokens": { "type": "array", "description": "Represents fungible tokens'es detailed information", "items": { "type": "object", "properties": { "amount": { "type": "string", "description": "Defines the amount of the fungible tokens.", "example": "0.254" }, "identifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the propertyId and for Ethereum-based transactions - the contract.", "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" }, "name": { "type": "string", "description": "Defines the token's name as a string.", "example": "Tether USD" }, "symbol": { "type": "string", "description": "Defines the symbol of the fungible tokens.", "example": "USDT" }, "tokenDecimals": { "type": "integer", "format": "int64", "description": "Defines the decimals of the token, i.e. the number of digits that come after the decimal coma of the token.", "example": 6 }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-20" } }, "required": [ "amount", "identifier", "name", "symbol", "tokenDecimals", "type" ] } }, "index": { "type": "string", "description": "Represents the index of the address in the wallet.", "example": "1" }, "label": { "type": "string", "description": "Represents a custom tag that customers can set up for their Wallets and addresses. E.g. custom label named \"Special addresses\".", "example": "yourStringHere" }, "nonFungibleTokens": { "type": "array", "description": "Represents non-fungible tokens'es detailed information.", "items": { "type": "object", "properties": { "identifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the propertyId and for Ethereum-based transactions - the contract.", "example": "0x90ca8a3eb2574f937f514749ce619fdcca187d45" }, "name": { "type": "string", "description": "Defines the token's name as a string.", "example": "Tether" }, "symbol": { "type": "string", "description": "Defines the symbol of the non-fungible tokens.", "example": "ENS" }, "tokenId": { "type": "string", "description": "Represents tokens' unique identifier.", "example": "0x000000000000000000000000000000000000000000000000000000000000195b" }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-721" } }, "required": [ "identifier", "name", "symbol", "tokenId", "type" ] } } }, "required": [ "address", "confirmedBalance", "createdTimestamp", "fungibleTokens", "index", "label", "nonFungibleTokens" ] }, "ListDepositAddressesR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, "offset": { "type": "integer", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 }, "total": { "type": "integer", "description": "Defines the total number of items returned in the response.", "example": 100 }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/ListDepositAddressesRI" }, "example": [] } }, "required": [ "limit", "items", "offset", "total" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "ListDepositAddressesE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "ListDepositAddressesE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "ListDepositAddressesE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "GetVaultAssetDetailsRI": { "type": "object", "properties": { "confirmedBalance": { "type": "object", "description": "Specifies the confirmed balance.", "properties": { "amount": { "type": "string", "description": "Specifies the amount of the confirmed balance.", "example": "0.0101" }, "unit": { "type": "string", "description": "Specifies the unit of the amount of the confirmed balance.", "example": "BTC" } }, "required": [ "amount", "unit" ] }, "depositAddressesCount": { "type": "integer", "description": "Specifies the count of deposit addresses in the Wallet.", "example": 5 }, "fungibleTokens": { "type": "array", "description": "Represents fungible tokens'es detailed information", "items": { "type": "object", "properties": { "confirmedAmount": { "type": "string", "description": "Defines the amount of the fungible tokens.", "example": "0.254" }, "identifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the propertyId and for Ethereum-based transactions - the contract.", "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" }, "symbol": { "type": "string", "description": "Defines the symbol of the fungible tokens.", "example": "USDT" }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-20" } }, "required": [ "confirmedAmount", "identifier", "symbol", "type" ] } }, "name": { "type": "string", "description": "Defines the name of the Wallet given to it by the user.", "example": "main vault" }, "nonFungibleTokens": { "type": "array", "description": "Represents non-fungible tokens'es detailed information.", "items": { "type": "object", "properties": { "identifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the propertyId and for Ethereum-based transactions - the contract.", "example": "0x90ca8a3eb2574f937f514749ce619fdcca187d45" }, "symbol": { "type": "string", "description": "Defines the symbol of the non-fungible tokens.", "example": "ENS" }, "tokenId": { "type": "string", "description": "Represents tokens' unique identifier.", "example": "0x000000000000000000000000000000000000000000000000000000000000195b" }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-721" } }, "required": [ "identifier", "symbol", "tokenId", "type" ] } }, "recievedConfirmedAmount": { "type": "object", "description": "Specifies the confirmed amount that has been received.", "properties": { "amount": { "type": "string", "description": "Specifies the confirmed amount that has been received.", "example": "0.0345" }, "unit": { "type": "string", "description": "Specifies the unit of the confirmed amount that has been received.", "example": "BTC" } }, "required": [ "amount", "unit" ] }, "sentConfirmedAmount": { "type": "object", "description": "Specifies the confirmed amount that has been sent.", "properties": { "amount": { "type": "string", "description": "Specifies the confirmed amount that has been sent.", "example": "0.0134" }, "unit": { "type": "string", "description": "Specifies the unit of the confirmed amount that has been sent.", "example": "BTC" } }, "required": [ "amount", "unit" ] } }, "required": [ "confirmedBalance", "depositAddressesCount", "fungibleTokens", "name", "nonFungibleTokens", "recievedConfirmedAmount", "sentConfirmedAmount" ] }, "GetVaultAssetDetailsR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/GetVaultAssetDetailsRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "GetVaultAssetDetailsE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "GetVaultAssetDetailsE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "GetVaultAssetDetailsE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "CreateFungibleTokensTransactionRequestFromAddressRI": { "type": "object", "properties": { "feePriority": { "type": "string", "description": "Represents the fee priority of the automation, whether it is \"slow\", \"standard\" or \"fast\".", "example": "fast", "enum": [ "slow", "standard", "fast" ] }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipients": { "type": "array", "description": "Defines the destination for the transaction, i.e. the recipient(s).", "example": "0x1316bea88fb7cd4ccc4a57e2f9f4f43d1a86ee59", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Defines the destination address.", "example": "0xc6d46aba0c6e2eb6358c4e24804158cc4d847922" }, "amount": { "type": "string", "description": "Defines the amount sent to the destination address.", "example": "1" } }, "required": [ "address", "amount" ] } }, "senders": { "type": "object", "description": "Defines details about the source, i.e. the sender.", "properties": { "address": { "type": "string", "description": "Defines the sender's public address.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" } }, "required": [ "address" ] }, "tokenTypeSpecificData": { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressRIS" }, "transactionRequestId": { "type": "string", "description": "Represents a unique identifier of the transaction request (the request sent to make a transaction), which helps in identifying which callback and which `referenceId` concern that specific transaction request.", "example": "6038d09050653d1f0e40584c" } }, "required": [ "feePriority", "recipients", "senders", "tokenTypeSpecificData", "transactionRequestId" ] }, "CreateFungibleTokensTransactionRequestFromAddressR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "CreateFungibleTokensTransactionRequestFromAddressE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "CreateFungibleTokensTransactionRequestFromAddressE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "CreateFungibleTokensTransactionRequestFromAddressE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "CreateFungibleTokensTransactionRequestFromAddressE409": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/InvalidData" }, { "$ref": "#/components/schemas/WalletAsAServiceWalletBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceAddressBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceTokenNotSupported" } ] }, "WalletAsAServiceTokenNotSupported": { "type": "object", "description": "wallet_as_a_service_token_not_supported", "properties": { "code": { "type": "string", "description": "Specifies an error code, e.g. error 404.", "example": "wallet_as_a_service_token_not_supported" }, "message": { "type": "string", "description": "Specifies the message of the error, i.e. why the error was returned, e.g. error 404 stands for \u201cnot found\u201d.", "example": "The token is not supported for this blockchain and network. To be supported, please contact our team." }, "details": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string", "description": "Specifies an attribute of the error by name.", "example": "attribute which content caused the error" }, "message": { "type": "string", "description": "Specifies the details of an attribute as part from the error.", "example": "message describing the error" } }, "required": [ "attribute", "message" ] } } }, "required": [ "code", "message" ] }, "ListAllAssetsFromAllVaultsRI": { "type": "object", "properties": { "coins": { "type": "array", "items": { "type": "object", "properties": { "blockchain": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin" }, "confirmedBalance": { "type": "string", "description": "Defines the total balance of the address that is confirmed. It doesn't include unconfirmed transactions.", "example": "0.00009179" }, "network": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet" }, "totalReceived": { "type": "string", "description": "Defines the total amount of all coins received to the address, based on confirmed transactions.", "example": "5.6" }, "totalSpent": { "type": "string", "description": "Defines the total amount of all spent by this address coins, based on confirmed transactions.", "example": "2.1" }, "unit": { "type": "string", "description": "Represents the unit of the confirmed balance.", "example": "BTC" } }, "required": [ "blockchain", "confirmedBalance", "network", "totalReceived", "totalSpent", "unit" ] } }, "fungibleTokens": { "type": "array", "description": "Represents fungible tokens'es detailed information", "items": { "type": "object", "properties": { "amount": { "type": "string", "description": "Defines the amount of the fungible tokens.", "example": "0.254" }, "blockchain": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, "identifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the propertyId and for Ethereum-based transactions - the contract.", "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" }, "network": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"ropsten\" are test networks.", "example": "mainnet" }, "symbol": { "type": "string", "description": "Defines the symbol of the fungible tokens.", "example": "USDT" }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-20" } }, "required": [ "amount", "blockchain", "identifier", "network", "symbol", "type" ] } }, "nonFungibleTokens": { "type": "array", "description": "Represents non-fungible tokens'es detailed information.", "items": { "type": "object", "properties": { "blockchain": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, "identifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the propertyId and for Ethereum-based transactions - the contract.", "example": "0x90ca8a3eb2574f937f514749ce619fdcca187d45" }, "network": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"ropsten\" are test networks.", "example": "goerli" }, "symbol": { "type": "string", "description": "Defines the symbol of the non-fungible tokens.", "example": "ENS" }, "tokenId": { "type": "string", "description": "Represents tokens' unique identifier.", "example": "0x000000000000000000000000000000000000000000000000000000000000195b" }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-721" } }, "required": [ "blockchain", "identifier", "network", "symbol", "tokenId", "type" ] } }, "walletId": { "type": "string", "description": "Defines the unique ID of the Wallet.", "example": "60c9d9921c38030006675ff6" }, "walletName": { "type": "string", "description": "Represents the name of the wallet.", "example": "exampleName" } }, "required": [ "coins", "fungibleTokens", "nonFungibleTokens", "walletId", "walletName" ] }, "ListAllAssetsFromAllVaultsR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, "offset": { "type": "integer", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 }, "total": { "type": "integer", "description": "Defines the total number of items returned in the response.", "example": 100 }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/ListAllAssetsFromAllVaultsRI" }, "example": [] } }, "required": [ "limit", "items", "offset", "total" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "ListAllAssetsFromAllVaultsE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "ListAllAssetsFromAllVaultsE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "ListAllAssetsFromAllVaultsE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" } ] }, "ListAllAssetsByVaultIDRI": { "type": "object", "properties": { "coins": { "type": "array", "items": { "type": "object", "properties": { "blockchain": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin" }, "confirmedBalance": { "type": "string", "description": "Defines the total balance of the address that is confirmed. It doesn't include unconfirmed transactions.", "example": "0.00009179" }, "network": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet" }, "totalReceived": { "type": "string", "description": "Defines the total amount of all coins received to the address, based on confirmed transactions.", "example": "5.6" }, "totalSpent": { "type": "string", "description": "Defines the total amount of all spent by this address coins, based on confirmed transactions.", "example": "2.1" }, "unit": { "type": "string", "description": "Represents the unit of the confirmed balance.", "example": "BTC" } }, "required": [ "blockchain", "confirmedBalance", "network", "totalReceived", "totalSpent", "unit" ] } }, "fungibleTokens": { "type": "array", "description": "Represents fungible tokens'es detailed information", "items": { "type": "object", "properties": { "amount": { "type": "string", "description": "Defines the amount of the fungible tokens.", "example": "0.254" }, "blockchain": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, "identifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the propertyId and for Ethereum-based transactions - the contract.", "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" }, "network": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "mainnet" }, "symbol": { "type": "string", "description": "Defines the symbol of the fungible tokens.", "example": "USDT" }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-20" } }, "required": [ "amount", "blockchain", "identifier", "network", "symbol", "type" ] } }, "nonFungibleTokens": { "type": "array", "description": "Represents non-fungible tokens'es detailed information.", "items": { "type": "object", "properties": { "blockchain": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, "identifier": { "type": "string", "description": "Defines the specific token identifier. For Bitcoin-based transactions it should be the propertyId and for Ethereum-based transactions - the contract.", "example": "0x90ca8a3eb2574f937f514749ce619fdcca187d45" }, "network": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli" }, "symbol": { "type": "string", "description": "Defines the symbol of the non-fungible tokens.", "example": "ENS" }, "tokenId": { "type": "string", "description": "Represents tokens' unique identifier.", "example": "0x000000000000000000000000000000000000000000000000000000000000195b" }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-721" } }, "required": [ "blockchain", "identifier", "network", "symbol", "tokenId", "type" ] } }, "walletId": { "type": "string", "description": "Defines the unique ID of the Wallet.", "example": "60c9d9921c38030006675ff6" }, "walletName": { "type": "string", "description": "Represents the name of the wallet.", "example": "exampleName" } }, "required": [ "coins", "fungibleTokens", "nonFungibleTokens", "walletId", "walletName" ] }, "ListAllAssetsByVaultIDR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/ListAllAssetsByVaultIDRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "ListAllAssetsByVaultIDE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "ListAllAssetsByVaultIDE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "ListAllAssetsByVaultIDE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" } ] }, "GetTransactionRequestDetailsRI": { "type": "object", "properties": { "additionalDetails": { "type": "string", "description": "Defines an optional note for additional details.", "example": "yourExampleStringHere" }, "blockchain": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin", "enum": [ "bitcoin", "bitcoin-cash", "litecoin", "dogecoin", "dash", "ethereum", "ethereum-classic", "xrp", "zcash" ] }, "feePriority": { "type": "string", "description": "Defines the priority for the fee, if it is \"slow\", \"standard\" or \"fast\".", "example": "standard", "enum": [ "slow", "standard", "fast" ] }, "network": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet", "enum": [ "mainnet", "testnet", "mordor", "goerli" ] }, "recipients": { "type": "array", "description": "Represents a list of recipient addresses with the respective amounts. In account-based protocols like Ethereum there is only one address in this list.", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address which receives this transaction. In UTXO-based protocols like Bitcoin there could be several senders while in account-based protocols like Ethereum there is always only one recipient.", "example": "mr3zKBc7skyDHcVHWww4JzzziPnrdYTscR" }, "addressTag": { "type": "integer", "description": "Defines a specific Tag that is an additional XRP address feature. It helps identify a transaction recipient beyond a wallet address. The tag that was encoded into the x-Address along with the Classic Address.", "example": 3999472835 }, "amount": { "type": "string", "description": "Represents the amount received to this address.", "example": "0.001" }, "classicAddress": { "type": "string", "description": "Represents the public address, which is a compressed and shortened form of a public key. A classic address is shown when the destination address is an x-Address.", "example": "rA9bXGJcXvZKaWofrRphdJsBWzhyCfH3z" }, "unit": { "type": "string", "description": "Defines the unit of the amount.", "example": "BTC" } }, "required": [ "address", "amount", "unit" ] } }, "totalTransactionAmount": { "type": "string", "description": "Defines the total transaction amount.", "example": "0.001" }, "transactionId": { "type": "string", "description": "Represents the unique identifier of a transaction, i.e. it could be transactionId in UTXO-based protocols like Bitcoin, and transaction hash in Ethereum blockchain.", "example": "61922aa68f192800067a8404" }, "transactionRequestStatus": { "type": "string", "description": "Defines the status of the transaction request, e.g. pending.", "example": "created", "enum": [ "created", "await-approval", "pending", "prepared", "signed", "broadcasted", "success", "failed", "rejected", "mined" ] }, "transactionType": { "type": "string", "description": "Defines the transaction type, if it is for coins or tokens.", "example": "coin", "enum": [ "coin", "token" ] }, "unit": { "type": "string", "description": "Defines the unit of the amount.", "example": "BTC" }, "walletId": { "type": "string", "description": "Defines the unique ID of the Wallet.", "example": "60c9d9921c38030006675ff6" } }, "required": [ "additionalDetails", "blockchain", "feePriority", "network", "recipients", "totalTransactionAmount", "transactionRequestStatus", "transactionType", "unit", "walletId" ] }, "GetTransactionRequestDetailsR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/GetTransactionRequestDetailsRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "GetTransactionRequestDetailsE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "GetTransactionRequestDetailsE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "GetTransactionRequestDetailsE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" } ] }, "CreateSingleTransactionRequestFromAddressWithoutFeePriorityRI": { "type": "object", "properties": { "classicAddress": { "type": "string", "description": "Represents the public address, which is a compressed and shortened form of a public key. The classic address is shown when the source address is an x-Address.", "example": "TX8VXpdEoNNrKeEuNTfbEXfa9eZivcyUwD" }, "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipient": { "type": "array", "description": "Defines the destination for the transaction, i.e. the recipient(s).", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Defines the destination address.", "example": "TX8VXpdEoNNrKeEuNTfbEXfa9eZivcyUwD" }, "amount": { "type": "string", "description": "Defines the amount sent to the destination address.", "example": "0.0006" }, "classicAddress": { "type": "string", "description": "Represents the public address, which is a compressed and shortened form of a public key. The classic address is shown when the source address is an x-Address.", "example": "TMVeigwYyuXJVHER4oA2yQzsFFSN2JfXkt" }, "unit": { "type": "string", "description": "Defines the unit of the recieved amount for the address.", "example": "TRX" } }, "required": [ "address", "amount", "unit" ] } }, "sender": { "type": "object", "description": "Defines details about the source, i.e. the sender.", "properties": { "address": { "type": "string", "description": "Defines the sender's public address.", "example": "TX8VXpdEoNNrKeEuNTfbEXfa9eZivcyUwD" } }, "required": [ "address" ] }, "transactionRequestId": { "type": "string", "description": "Represents a unique identifier of the transaction request (the request sent to make a transaction), which helps in identifying which callback and which `referenceId` concern that specific transaction request.", "example": "62da9f003d20a65c737af83f" }, "transactionRequestStatus": { "type": "string", "description": "Defines the status of the transaction, e.g. \"created, \"await_approval\", \"pending\", \"prepared\", \"signed\", \"broadcasted\", \"success\", \"failed\", \"rejected\", mined\".", "example": "created", "enum": [ "created", "await-approval", "pending", "prepared", "signed", "broadcasted", "success", "failed", "rejected", "mined", "mined-with-errors" ] }, "totalAmount": { "type": "object", "properties": { "unit": { "type": "string", "description": "Defines the unit of the total amount transacted.", "example": "TRX" }, "value": { "type": "string", "description": "Total amount of the transaction", "example": "0.0006" } } } }, "required": [ "recipient", "sender", "transactionRequestId", "transactionRequestStatus" ] }, "CreateSingleTransactionRequestFromAddressWithoutFeePriorityR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/CreateSingleTransactionRequestFromAddressWithoutFeePriorityRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "CreateSingleTransactionRequestFromAddressWithoutFeePriorityE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "CreateSingleTransactionRequestFromAddressWithoutFeePriorityE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "CreateSingleTransactionRequestFromAddressWithoutFeePriorityE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "CreateSingleTransactionRequestFromAddressWithoutFeePriorityE409": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/InvalidData" }, { "$ref": "#/components/schemas/WalletAsAServiceWalletBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceAddressBalanceNotEnough" } ] }, "ListVaultTransactionsRI": { "type": "object", "properties": { "direction": { "type": "string", "description": "Defines the direction of the transaction, e.g. incoming.", "example": "incoming" }, "fee": { "type": "object", "properties": { "amount": { "type": "string", "description": "Defines the fee for the transaction.", "example": "0.00003" }, "convertedAmount": { "type": "string", "description": "Defines the converted amount of the transaction's fee.", "example": "1.50" }, "exchangeRateUnit": { "type": "string", "description": "Defines the exchange rate for the transaction's unit.", "example": "USD" }, "symbol": { "type": "string", "description": "Defines the unit of the transaction's fee.", "example": "ETH" } }, "required": [ "amount", "convertedAmount", "exchangeRateUnit", "symbol" ] }, "fungibleTokens": { "type": "array", "description": "Represents fungible tokens'es detailed information", "items": { "type": "object", "properties": { "amount": { "type": "string", "description": "Defines the amount of the fungible tokens.", "example": "0.254" }, "convertedAmount": { "type": "string", "description": "Defines the tokens' converted amount value.", "example": "0.0034" }, "exchangeRateUnit": { "type": "string", "description": "Represents token's exchange rate unit.", "example": "USD" }, "name": { "type": "string", "description": "Defines the token's name as a string.", "example": "Tether USD" }, "recipient": { "type": "string", "description": "The address which receives this transaction. In UTXO-based protocols like Bitcoin there could be several senders while in account-based protocols like Ethereum there is always only one", "example": "0x229f7172eab232d09d2de05a3e3b7b79c9abfe3b" }, "sender": { "type": "string", "description": "Represents the address which sends this transaction. In UTXO-based protocols like Bitcoin there could be several senders while in account-based protocols like Ethereum there is always only one sender.", "example": "0x1b7aa44088a0ea95bdc65fef6e5071e946bf7d8f" }, "symbol": { "type": "string", "description": "Defines the symbol of the fungible tokens.", "example": "ETH" }, "tokenDecimals": { "type": "integer", "description": "Defines the decimals of the token, i.e. the number of digits that come after the decimal coma of the token.", "example": 6 }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-20" } }, "required": [ "amount", "convertedAmount", "exchangeRateUnit", "name", "recipient", "sender", "symbol", "tokenDecimals", "type" ] } }, "internalTransactions": { "type": "array", "items": { "type": "object", "properties": { "amount": { "type": "string", "description": "Defines the specific amount of the transaction.", "example": "0.001" }, "convertedAmount": { "type": "string", "description": "Represents the converted amount.", "example": "4.30365936483792" }, "exchangeRateUnit": { "type": "string", "description": "Defines the base asset symbol to get a rate for.", "example": "USD" }, "operationId": { "type": "string", "description": "Represents the unique internal transaction ID in regards to the parent transaction (type trace address).", "example": "call_0" }, "recipient": { "type": "string", "description": "Represents the recipient address with the respective amount.", "example": "0x07344b7649c5ff096b0317957d9a208931d04d5e" }, "sender": { "type": "string", "description": "Represents the sender address with the respective amount.", "example": "0x4b8ec9e58a8b08f3803f84fb52d0a50e84444592" }, "symbol": { "type": "string", "description": "Represents the unique unit symbol.", "example": "ETH" } }, "required": [ "amount", "convertedAmount", "exchangeRateUnit", "operationId", "recipient", "sender", "symbol" ] } }, "nonFungibleTokens": { "type": "array", "description": "Represents non-fungible tokens'es detailed information.", "items": { "type": "object", "properties": { "convertedAmount": { "type": "string", "description": "Defines the tokens' converted amount value.", "example": "0.034" }, "exchangeRateUnit": { "type": "string", "description": "Represents token's exchange rate unit.", "example": "USD" }, "name": { "type": "string", "description": "Defines the token's name as a string.", "example": "Axie Infinity" }, "recipient": { "type": "string", "description": "Defines the address to which the recipient receives the transferred tokens.", "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" }, "sender": { "type": "string", "description": "Defines the address from which the sender transfers tokens.", "example": "0x65b895f400dae5541d70cbbec07527210158f6e2" }, "symbol": { "type": "string", "description": "Defines the symbol of the non-fungible tokens.", "example": "AXS" }, "tokenId": { "type": "string", "description": "Represents tokens' unique identifier.", "example": "13383" }, "type": { "type": "string", "description": "Defines the specific token type.", "example": "ERC-721" } }, "required": [ "convertedAmount", "exchangeRateUnit", "name", "recipient", "sender", "symbol", "tokenId", "type" ] } }, "recipients": { "type": "array", "description": "Represents a list of recipient addresses with the respective amounts. In account-based protocols like Ethereum there is only one address in this list.", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address which receives this transaction. In UTXO-based protocols like Bitcoin there could be several senders while in account-based protocols like Ethereum there is always only one recipient.", "example": "0x6f61e3c2fbb8c8be698bd0907ba6c04b62800fe5" }, "amount": { "type": "string", "description": "Represents the amount received to this address.", "example": "0.00427167" }, "label": { "type": "string", "description": "Defines a plain text string as a label for the recipient.", "example": "yourStringHere" } }, "required": [ "address", "amount" ] } }, "senders": { "type": "array", "description": "Represents a list of sender addresses with the respective amounts. In account-based protocols like Ethereum there is only one address in this list.", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Represents the address which sends this transaction. In UTXO-based protocols like Bitcoin there could be several senders while in account-based protocols like Ethereum there is always only one sender.", "example": "0x6f61e3c2fbb8c8be698bd0907ba6c04b62800fe5" }, "amount": { "type": "string", "description": "Represents the total amount sent by this address including the fee.", "example": "0.0001" }, "label": { "type": "string", "description": "Defines a plain text string as a label for the sender.", "example": "yourStringHere" } }, "required": [ "address", "amount" ] } }, "status": { "type": "string", "description": "Defines the status of the transaction, if it is confirmed or unconfirmed.", "example": "confirmed" }, "timestamp": { "type": "integer", "description": "Defines the exact date/time in Unix Timestamp when this transaction was mined, confirmed or first seen in Mempool, if it is unconfirmed.", "example": 1622466746 }, "transactionId": { "type": "string", "description": "Represents the unique TD of the transaction.", "example": "b3ddf04d74e5bd57f3ccb5375db6f39d228ed98cfa1ae9bf959b9406fc975f01" }, "value": { "type": "object", "properties": { "amount": { "type": "string", "description": "Defines the transaction amount.", "example": "0.001" }, "convertedAmount": { "type": "string", "description": "Defines the converted amount of the transaction as a string.", "example": "150" }, "exchangeRateUnit": { "type": "string", "description": "Defines the exchange rate's unit.", "example": "USD" }, "symbol": { "type": "string", "description": "Defines the unit of the transaction's amount.", "example": "ETH" } }, "required": [ "amount", "convertedAmount", "exchangeRateUnit", "symbol" ] } }, "required": [ "direction", "fee", "recipients", "senders", "status", "timestamp", "transactionId", "value" ] }, "ListVaultTransactionsR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, "offset": { "type": "integer", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 }, "total": { "type": "integer", "description": "Defines the total number of items returned in the response.", "example": 100 }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/ListVaultTransactionsRI" }, "example": [] } }, "required": [ "limit", "items", "offset", "total" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "ListVaultTransactionsE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "ListVaultTransactionsE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "ListVaultTransactionsE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityRI": { "type": "object", "properties": { "note": { "type": "string", "description": "Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.", "example": "yourAdditionalInformationhere" }, "recipient": { "type": "array", "description": "Defines the destination for the transaction, i.e. the recipient(s).", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Defines the destination address.", "example": "TMVeigwYyuXJVHER4oA2yQzsFFSN2JfXkt" }, "amount": { "type": "string", "description": "Defines the amount sent to the destination address.", "example": "0.2568" }, "unit": { "type": "string", "description": "Represents the unit of the tokens amount recieved.", "example": "JST" } }, "required": [ "address", "amount", "unit" ] } }, "sender": { "type": "object", "description": "Defines details about the source, i.e. the sender.", "properties": { "address": { "type": "string", "description": "Defines the sender's public address.", "example": "TX8VXpdEoNNrKeEuNTfbEXfa9eZivcyUwD" } }, "required": [ "address" ] }, "tokenTypeSpecificData": { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityRIS" }, "transactionRequestId": { "type": "string", "description": "Represents a unique identifier of the transaction request (the request sent to make a transaction), which helps in identifying which callback and which `referenceId` concern that specific transaction request.", "example": "62daacdbc8a7282e9ea01c35" } }, "required": [ "recipient", "sender", "tokenTypeSpecificData", "transactionRequestId" ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" }, { "$ref": "#/components/schemas/WalletAsAServiceProvidedNetworkIsNotSuitableForThisWalletType" } ] }, "CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityE409": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/InvalidData" }, { "$ref": "#/components/schemas/WalletAsAServiceWalletBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceAddressBalanceNotEnough" }, { "$ref": "#/components/schemas/WalletAsAServiceTokenNotSupported" } ] }, "GetVaultTransactionDetailsByTransactionIDRIBSB": { "type": "object", "properties": { "locktime": { "type": "integer", "format": "int64", "description": "Represents the time at which a particular transaction can be added to the blockchain.", "example": 0 }, "size": { "type": "integer", "description": "Represents the total size of this transaction.", "example": 591 }, "vSize": { "type": "integer", "description": "Represents the virtual size of this transaction.", "example": 347 }, "version": { "type": "integer", "description": "Represents the transaction version number.", "example": 2 }, "vin": { "type": "array", "description": "Object Array representation of transaction inputs", "items": { "type": "object", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send/receive the amount.", "example": "2NDxh6gwyx33zCxocteVXo9znPny1GrUuHF" } }, "coinbase": { "type": "string", "description": "Represents the coinbase hex.", "example": "0399991d20706f6f6c2e656e6a6f79626f646965732e636f6d20393963336532346234374747a53e994c4a000001" }, "scriptSig": { "type": "object", "description": "Object representation of the script", "properties": { "asm": { "type": "string", "description": "The asm strands for assembly, which is the symbolic representation of the Bitcoin's Script language op-codes.", "example": "00148b3ed2c15710b61a43cb354a7e637dc6bbd448ce" }, "hex": { "type": "string", "description": "Represents the hex of the public key of the address.", "example": "1600148b3ed2c15710b61a43cb354a7e637dc6bbd448ce" }, "type": { "type": "string", "description": "Represents the script type of the reference transaction identifier.", "example": "scripthash" } }, "required": [ "asm", "hex", "type" ] }, "sequence": { "type": "integer", "format": "int64", "description": "Represents the script sequence number.", "example": 4294967295 }, "txid": { "type": "string", "description": "Represents the reference transaction identifier.", "example": "48bd74754b71181d4d2092fc24477f89fa7dfea8059b140a179bac2267048832" }, "txinwitness": { "type": "array", "items": { "type": "string", "description": "Represents an array hex-encoded witness data (if there is any) as strings.", "example": "3045022100ee88c1b067d5756831343059a3632106b218ef158fe062725c69a2a21b1504af02207c95262daaefdf9c46f55e53cc42fa152bd874a5ea54dd155a4f2624782be1af01" } }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.00001681" }, "vout": { "type": "integer", "description": "It refers to the index of the output address of this transaction. The index starts from 0.", "example": 0 } }, "required": [ "addresses", "scriptSig", "sequence", "txid", "vout" ] } }, "vout": { "type": "array", "description": "Represents the transaction outputs.", "items": { "type": "object", "properties": { "isSpent": { "type": "boolean", "description": "Defines whether the output is spent or not.", "example": false }, "scriptPubKey": { "type": "object", "description": "Object representation of the script", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send the amount.", "example": "2NGHH9qxCADY5eTNFUKobi1xiMWoW6FYSCd" } }, "asm": { "type": "string", "description": "Represents the assembly of the script public key of the address.", "example": "OP_HASH160 fcae5de86db6ca7121f44a0a01fd2d3b85137e07 OP_EQUA" }, "hex": { "type": "string", "description": "Represents the hex of the script public key of the address.", "example": "a914fcae5de86db6ca7121f44a0a01fd2d3b85137e0787" }, "reqSigs": { "type": "integer", "description": "Represents the required signatures.", "example": 1 }, "type": { "type": "string", "description": "Represents the script type.", "example": "witness_v0_keyhash" } }, "required": [ "addresses", "asm", "hex", "type" ] }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.00004069" } }, "required": [ "isSpent", "scriptPubKey", "value" ] } } }, "description": "Bitcoin", "required": [ "locktime", "size", "vSize", "version", "vin", "vout" ] }, "GetVaultTransactionDetailsByTransactionIDRIBSE": { "type": "object", "properties": { "contract": { "type": "string", "description": "Represents the specific transaction contract.", "example": "0x20fe562d797a42dcb3399062ae9546cd06f63280" }, "gasLimit": { "type": "string", "description": "Represents the amount of gas used by this specific transaction alone.", "example": "21000" }, "gasPrice": { "type": "object", "properties": { "amount": { "type": "string", "description": "Represents the price offered to the miner to purchase this amount of gas.", "example": "10354241269" }, "unit": { "type": "string", "description": "Defines the unit of the gas price amount, e.g. BTC, ETH, XRP.", "example": "WEI" } }, "required": [ "amount", "unit" ] }, "gasUsed": { "type": "string", "description": "Represents the exact unit of gas that was used for the transaction.", "example": "21000" }, "inputData": { "type": "string", "description": "Represents additional information that is required for the transaction.", "example": "0x67a5cd0600000000000000000000000031f42841c2db5173425b5223809cf3a38fede360" }, "nonce": { "type": "integer", "description": "Represents the sequential running number for an address, starting from 0 for the first transaction. E.g., if the nonce of a transaction is 10, it would be the 11th transaction sent from the sender's address.", "example": 16 }, "transactionStatus": { "type": "string", "description": "String representation of the transaction status", "example": "0x1" } }, "description": "Ethereum", "required": [ "contract", "gasLimit", "gasPrice", "gasUsed", "inputData", "nonce", "transactionStatus" ] }, "GetVaultTransactionDetailsByTransactionIDRIBSL": { "type": "object", "properties": { "locktime": { "type": "integer", "format": "int64", "description": "Represents the time at which a particular transaction can be added to the blockchain.", "example": 2 }, "size": { "type": "integer", "description": "Represents the total size of this transaction.", "example": 223 }, "vSize": { "type": "integer", "description": "Represents the virtual size of this transaction.", "example": 141 }, "version": { "type": "integer", "description": "Represents the transaction version number.", "example": 1 }, "vin": { "type": "array", "description": "Object Array representation of transaction inputs", "items": { "type": "object", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send/receive the amount.", "example": "LZ891CJWn54CpE6yJ4T3mzP8Xxwrg9gDpH" } }, "coinbase": { "type": "string", "description": "Represents the coinbase hex.", "example": "0399d620046183f4502cfabe6d6d54cff85e53693837dc613bc4cc4b78986c2193a4e2902e3da62aa311957f50844000000000000000042f4c502f08220000b0e1110000" }, "scriptSig": { "type": "object", "description": "Object representation of the script", "properties": { "asm": { "type": "string", "description": "The asm strands for assembly, which is the symbolic representation of the Bitcoin's Script language op-codes.", "example": "3045022100f031442894c0fd60c195fbdb29c0bf72f143a815689b8840cd31ec31cc6a7721022028f74f0869e4666761c9ba1035cc714528a17de873dfc7b3a541d29f3942a2d8[ALL] 028c533b6c0ce0ad714a8af36b64d207c4f61cd6d5af210362447c92b4105a4fab" }, "hex": { "type": "string", "description": "Represents the hex of the public key of the address.", "example": "483045022100f031442894c0fd60c195fbdb29c0bf72f143a815689b8840cd31ec31cc6a7721022028f74f0869e4666761c9ba1035cc714528a17de873dfc7b3a541d29f3942a2d80121028c533b6c0ce0ad714a8af36b64d207c4f61cd6d5af210362447c92b4105a4fab" }, "type": { "type": "string", "description": "Represents the script type of the reference transaction identifier.", "example": "scripthash" } }, "required": [ "asm", "hex", "type" ] }, "sequence": { "type": "integer", "format": "int64", "description": "Represents the script sequence number.", "example": 4294967294 }, "txid": { "type": "string", "description": "Represents the reference transaction identifier.", "example": "1db56e1e8dfab84f6f0e33f8ddb160c9b16286471a3b486d79ea85bcf4d076b2" }, "txinwitness": { "type": "array", "items": { "type": "string", "description": "Represents an array hex-encoded witness data (if there is any) as strings.", "example": "304402204e88dfe79e58b640908812c496ea74d2941c23e70ee3d93ebd469dbd136afe0c02203d7631427c0b5cb96e8a8b23b6c8c0c8112ecb5fb020ee2a7a70841564ed679b01" } }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.0225" }, "vout": { "type": "integer", "description": "It refers to the index of the output address of this transaction. The index starts from 0.", "example": 1 } }, "required": [ "addresses", "coinbase", "scriptSig", "sequence", "txid", "value", "vout" ] } }, "vout": { "type": "array", "description": "Object Array representation of transaction outputs", "items": { "type": "object", "properties": { "isSpent": { "type": "boolean", "description": "Defines whether the output is spent or not.", "example": false }, "scriptPubKey": { "type": "object", "description": "Represents the script public key.", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send the amount.", "example": "3LAAY4fp88RsNHkVW5DZJgqUdbMD5rVoqZ" } }, "asm": { "type": "string", "description": "Represents the assembly of the script public key of the address.", "example": "OP_HASH160 ca94af32587de4e5006685ffffc65a818ccd3fbc OP_EQUAL" }, "hex": { "type": "string", "description": "Represents the hex of the script public key of the address.", "example": "a914ca94af32587de4e5006685ffffc65a818ccd3fbc87" }, "reqSigs": { "type": "integer", "description": "Represents the required signatures.", "example": 1 }, "type": { "type": "string", "description": "Represents the script type.", "example": "scripthash" } }, "required": [ "addresses", "asm", "hex", "type" ] }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.03505975" } }, "required": [ "isSpent", "scriptPubKey", "value" ] } } }, "description": "Litecoin", "required": [ "locktime", "size", "vSize", "version", "vin", "vout" ] }, "GetVaultTransactionDetailsByTransactionIDRIBSBC": { "type": "object", "properties": { "locktime": { "type": "integer", "format": "int64", "description": "Represents the time at which a particular transaction can be added to the blockchain.", "example": 1781965 }, "size": { "type": "integer", "description": "Represents the total size of this transaction.", "example": 248 }, "version": { "type": "integer", "description": "Represents the transaction version number.", "example": 1 }, "vin": { "type": "array", "description": "Object Array representation of transaction inputs", "items": { "type": "object", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send/receive the amount.", "example": "qq0adqyntn2zl9tsyjfagnyda9j2gfjkk574lxyrxd" } }, "coinbase": { "type": "string", "description": "Represents the coinbase hex.", "example": "0399991d20706f6f6c2e656e6a6f79626f646965732e636f6d20393963336532346234374747a53e994c4a000001" }, "scriptSig": { "type": "object", "description": "Object representation of the script", "properties": { "asm": { "type": "string", "description": "The asm strands for assembly, which is the symbolic representation of the Bitcoin's Script language op-codes.", "example": "0014daaf6d5cb86befe42df851a4d1df052e663754c1" }, "hex": { "type": "string", "description": "Represents the hex of the public key of the address.", "example": "160014daaf6d5cb86befe42df851a4d1df052e663754c1" }, "type": { "type": "string", "description": "Represents the script type of the reference transaction identifier.", "example": "scripthash" } }, "required": [ "asm", "hex", "type" ] }, "sequence": { "type": "integer", "format": "int64", "description": "Represents the script sequence number.", "example": 4294967295 }, "txid": { "type": "string", "description": "Represents the reference transaction identifier.", "example": "caee978cae255bbe303ac86152679e46113a8b12925aa3afaa312d89d11ccbf8" }, "txinwitness": { "type": "array", "items": { "type": "string", "description": "Represents an array hex-encoded witness data (if there is any) as strings.", "example": "3045022100c11ea5740bcd69f0f68a4914279838014d28923134d18e05c5a5486dfd06cc8c02200dadccec3f07bed0d1040f9e5a155efa5fdd40fc91f92342578d26848da4c6b901" } }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.00873472" }, "vout": { "type": "integer", "description": "It refers to the index of the output address of this transaction. The index starts from 0.", "example": 1 } }, "required": [ "addresses", "scriptSig", "sequence", "txid" ] } }, "vout": { "type": "array", "description": "Object Array representation of transaction outputs", "items": { "type": "object", "properties": { "isSpent": { "type": "boolean", "description": "Defines whether the output is spent or not.", "example": false }, "scriptPubKey": { "type": "object", "description": "Represents the script public key.", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send the amount.", "example": "qqux7gek8sg6r9qjkrdmrvz6t4xet3ax3gztt2drzk" } }, "asm": { "type": "string", "description": "Represents the assembly of the script public key of the address.", "example": "OP_DUP OP_HASH160 386f23363c11a19412b0dbb1b05a5d4d95c7a68a OP_EQUALVERIFY OP_CHECKSIG" }, "hex": { "type": "string", "description": "Represents the hex of the script public key of the address.", "example": "a914507a5bd8cac1d9efdf4c0a4bfacb3e0abb4f8d1587" }, "reqSigs": { "type": "integer", "description": "Represents the required signatures.", "example": 1 }, "type": { "type": "string", "description": "Represents the script type.", "example": "pubkeyhash" } }, "required": [ "addresses", "asm", "hex", "type" ] }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.000122" } }, "required": [ "isSpent", "scriptPubKey", "value" ] } } }, "description": "Bitcoin Cash", "required": [ "locktime", "size", "version", "vin", "vout" ] }, "GetVaultTransactionDetailsByTransactionIDRIBSEC": { "type": "object", "properties": { "contract": { "type": "string", "description": "Represents the specific transaction contract.", "example": "0x20fe562d797a42dcb3399062ae9546cd06f63280" }, "gasLimit": { "type": "string", "description": "Represents the amount of gas used by this specific transaction alone.", "example": "552020" }, "gasPrice": { "type": "object", "properties": { "amount": { "type": "string", "description": "Represents the price offered to the miner to purchase this amount of gas.", "example": "2994782934" }, "unit": { "type": "string", "description": "Defines the unit of the gas price amount, e.g. BTC, ETH, XRP.", "example": "WEI" } }, "required": [ "amount", "unit" ] }, "gasUsed": { "type": "string", "description": "Represents the exact unit of gas that was used for the transaction.", "example": "24673" }, "inputData": { "type": "string", "description": "Represents additional information that is required for the transaction.", "example": "0xa9059cbb000000000000000000000000acc59ec2f7119dc7a9e69dcd124cff75caae05bf0000000000000000000000000000000000000000000000000000000000989680" }, "nonce": { "type": "integer", "description": "Represents the sequential running number for an address, starting from 0 for the first transaction. E.g., if the nonce of a transaction is 10, it would be the 11th transaction sent from the sender's address.", "example": 16 } }, "description": "Ethereum Classic", "required": [ "contract", "gasLimit", "gasPrice", "gasUsed", "inputData", "nonce" ] }, "GetVaultTransactionDetailsByTransactionIDRIBSD": { "type": "object", "properties": { "locktime": { "type": "integer", "format": "int64", "description": "Represents the time at which a particular transaction can be added to the blockchain.", "example": 0 }, "size": { "type": "integer", "description": "Represents the total size of this transaction.", "example": 266 }, "version": { "type": "integer", "description": "Represents the transaction version number.", "example": 1 }, "vin": { "type": "array", "description": "Object Array representation of transaction inputs", "items": { "type": "object", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send/receive the amount.", "example": "DPzdWPsKaGvRn3AH7WjBpnNVHhAPELDY4o" } }, "coinbase": { "type": "string", "description": "Represents the coinbase hex.", "example": "03dcf4150c0b2f454233322f414431322f04da88506004565cc01f0c3130fc5f4e050000000000000a626368706f6f6c172f20626974636f696e636173682e6e6574776f726b202f" }, "scriptSig": { "type": "object", "description": "Object representation of the script", "properties": { "asm": { "type": "string", "description": "The asm strands for assembly, which is the symbolic representation of the Bitcoin's Script language op-codes.", "example": "030483ff6271580681f4f7828c01df56d5aebfe982cbaa2922594be9eb6cf40206 OP_CHECKSIG" }, "hex": { "type": "string", "description": "Represents the hex of the public key of the address.", "example": "21030483ff6271580681f4f7828c01df56d5aebfe982cbaa2922594be9eb6cf40206ac" }, "type": { "type": "string", "description": "Represents the script type of the reference transaction identifier.", "example": "scripthash" } }, "required": [ "asm", "hex", "type" ] }, "sequence": { "type": "integer", "format": "int64", "description": "Represents the script sequence number.", "example": 4294967295 }, "txid": { "type": "string", "description": "Represents the reference transaction identifier." }, "txinwitness": { "type": "array", "items": { "type": "string", "description": "Represents an array hex-encoded witness data (if there is any) as strings.", "example": "qpq395ljesqakppupe3chd3n3jp60wd23ue00g66xx" } }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.0225" }, "vout": { "type": "integer", "description": "It refers to the index of the output address of this transaction. The index starts from 0.", "example": 1 } }, "required": [ "addresses", "scriptSig", "sequence", "value" ] } }, "vout": { "type": "array", "description": "Object Array representation of transaction outputs", "items": { "type": "object", "properties": { "isSpent": { "type": "boolean", "description": "Defines whether the output is spent or not.", "example": false }, "scriptPubKey": { "type": "object", "description": "Represents the script public key.", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send the amount.", "example": "yd5KMREs3GLMe6mTJYr3YrH1juwNwrFCfB" } }, "asm": { "type": "string", "description": "Represents the assembly of the script public key of the address.", "example": "OP_DUP OP_HASH160 430158211605af1f0fa26d90405199621bdae5cd OP_EQUALVERIFY OP_CHECKSIG" }, "hex": { "type": "string", "description": "Represents the hex of the script public key of the address.", "example": "76a914430158211605af1f0fa26d90405199621bdae5cd88ac" }, "reqSigs": { "type": "integer", "description": "Represents the required signatures.", "example": 1 }, "type": { "type": "string", "description": "Represents the script type.", "example": "scripthash" } }, "required": [ "addresses", "asm", "hex", "type" ] }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "11.25" } }, "required": [ "isSpent", "scriptPubKey", "value" ] } } }, "description": "Dogecoin", "required": [ "locktime", "size", "version", "vin", "vout" ] }, "GetVaultTransactionDetailsByTransactionIDRIBSD2": { "type": "object", "properties": { "locktime": { "type": "integer", "format": "int64", "description": "Represents the time at which a particular transaction can be added to the blockchain.", "example": 0 }, "size": { "type": "integer", "description": "Represents the total size of this transaction.", "example": 125 }, "version": { "type": "integer", "description": "Represents the transaction version number.", "example": 1 }, "vin": { "type": "array", "description": "Object Array representation of transaction inputs", "items": { "type": "object", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send/receive the amount.", "example": "7W7gfYstwDR6a2ZCxEidAuvshyomqJ8yXT" } }, "coinbase": { "type": "string", "description": "Represents the coinbase hex.", "example": "03dcf4150c0b2f454233322f414431322f04da88506004565cc01f0c3130fc5f4e050000000000000a626368706f6f6c172f20626974636f696e636173682e6e6574776f726b202f" }, "scriptSig": { "type": "object", "description": "Specifies the required signatures.", "properties": { "asm": { "type": "string", "description": "The asm strands for assembly, which is the symbolic representation of the Bitcoin's Script language op-codes.", "example": "OP_DUP OP_HASH160 1fd680935cd42f95702493d44c8de964a42656b5 OP_EQUALVERIFY OP_CHECKSIG" }, "hex": { "type": "string", "description": "Represents the hex of the public key of the address.", "example": "4197968cb34bfba488b4a2399f7959b823fefad79ca0b5ed3f3a4bec4c0286cab55b896b28bbbcd4e61cf584cecfd47063b18b481d8d680eafbf869ada1a02c52441210237a84e6d70e775f274e4cbd9f30f9f8b1a426e8b08a9f802a851ce501c930011" }, "type": { "type": "string", "description": "Represents the script type of the reference transaction identifier.", "example": "scripthash" } }, "required": [ "asm", "hex", "type" ] }, "sequence": { "type": "integer", "format": "int64", "description": "Represents the script sequence number.", "example": 4294967295 }, "txid": { "type": "string", "description": "Represents the reference transaction identifier.", "example": "f60cf447159b08e9857cbc96688ba80beff23c6f032f6545044ab40a771b15f5" }, "txinwitness": { "type": "array", "items": { "type": "string", "description": "Represents an array hex-encoded witness data (if there is any) as strings.", "example": "3045022100c11ea5740bcd69f0f68a4914279838014d28923134d18e05c5a5486dfd06cc8c02200dadccec3f07bed0d1040f9e5a155efa5fdd40fc91f92342578d26848da4c6b901" } }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.2354" }, "vout": { "type": "integer", "description": "It refers to the index of the output address of this transaction. The index starts from 0.", "example": 1 } }, "required": [ "addresses", "scriptSig", "sequence" ] } }, "vout": { "type": "array", "description": "Object Array representation of transaction outputs", "items": { "type": "object", "properties": { "isSpent": { "type": "boolean", "description": "Defines whether the output is spent or not.", "example": false }, "scriptPubKey": { "type": "object", "description": "Represents the script public key.", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send the amount." } }, "asm": { "type": "string", "description": "Represents the assembly of the script public key of the address.", "example": "OP_DUP OP_HASH160 4112d3f2cc01db043c0e638bb6338c83a7b9aa8f OP_EQUALVERIFY OP_CHECKSIG" }, "hex": { "type": "string", "description": "Represents the hex of the script public key of the address.", "example": "76a9144112d3f2cc01db043c0e638bb6338c83a7b9aa8f88ac" }, "reqSigs": { "type": "integer", "description": "Represents the required signatures.", "example": 1 }, "type": { "type": "string", "description": "Represents the script type.", "example": "scripthash" } }, "required": [ "addresses", "asm", "hex", "type" ] }, "value": { "type": "string", "description": "Represents the sent/received amount.", "example": "0.5896" } }, "required": [ "isSpent", "scriptPubKey", "value" ] } } }, "description": "Dash", "required": [ "locktime", "size", "version", "vin", "vout" ] }, "GetVaultTransactionDetailsByTransactionIDRIBSZ": { "type": "object", "properties": { "bindingSig": { "type": "string", "description": "It is used to enforce balance of Spend and Output transfers, in order to prevent their replay across transactions.", "example": "603624b3e78e0de0415dea320797a107076a9f7aabd39f44bc4957803330e9891cb33744ac2ec749c2d2d341f29467c49c0ae35bf34765e2fb7c4cda68584804" }, "expiryHeight": { "type": "integer", "description": "Represents a block height after which the transaction will expire.", "example": 0 }, "joinSplitPubKey": { "type": "string", "description": "Represents an encoding of a JoinSplitSig public validating key.", "example": "5d2673b4c727241410e42f214a39218e4f13354d77db8ec31243a7be7ed8e2b7" }, "joinSplitSig": { "type": "string", "description": "Is used to sign transactions that contain at least one JoinSplit description.", "example": "8b06b926d619ead780b0769e5997ded93f9851fd0efd4b667afc5bcc2792b26cd4a565b4efa7733535fdc09fa566ca59042785d7fd8043d37fdf9e144465080a" }, "locktime": { "type": "integer", "format": "int64", "description": "Represents the time at which a particular transaction can be added to the blockchain.", "example": 1781965 }, "overwintered": { "type": "boolean", "description": "\"Overwinter\" is the network upgrade for the Zcash blockchain.", "example": true }, "size": { "type": "integer", "description": "Represents the total size of this transaction.", "example": 234 }, "vJoinSplit": { "type": "array", "description": "Represents a sequence of JoinSplit descriptions using BCTV14 proofs.", "items": { "type": "object", "properties": { "anchor": { "type": "string", "description": "Defines a Merkle tree root of a note commitment tree which uniquely identifies a note commitment tree state given the assumed security properties of the Merkle tree\u2019s\r\nhash function.", "example": "d32ddbaf0d9dc8c10783c01fd9ba5bd0bc2e5efe3d1665d7d6771eb4393736b4" }, "cipherTexts": { "type": "array", "items": { "type": "string", "description": "Represents the cipher texts.", "example": "988a182a3e561e0cca18e38e3273b3c538c3e6f79077867eca4305e48cbc5e6d3ff680de602e44fb8869f1a8747d9e3775f2418d33c41233e3612d6ecf277346b85bcd0c1fbdf4c4c0da107bf84e02c82588bf02f4a6c23ed36f70a436f69a6fe6cc38634d69e34e3d3942ff06a7921153689b4b50e3799f0ce3d8a35d165beaecc0c91018e9a8c618ff7036fd14b95641229e42974054c70d1e080c909c382297c5698b9af9b9291d6851c718d3e771e6376bd6dd52f4624ad024b4d85426e32fcf531019eeea547fda3ecca87aceaa80982e8fe22db152c01635d24fe4f59d1979610cad898c169d88559bcd8847f82b2ac5ab2f8623eed55b0273982297a52e9cbb4523d6411a0d40f59faf0ff9f23783790027d5f5153d421d897c11b9da48e7218b7ce64c653283ecaffab78006b771aec20e05761d768f9347f96c566d47014eff083268622e81ce6c17e1e66227ee795cd3a7efb77c3b5b4a896d75111a2a846be94c0fcdaab69ca2101a499c817590c4d1ea8b39145f0168210af4ac86cc6018e95c0699a6f1275c2934cbe1cf84bbeee12ed77b54fe4c2f6b1c0187e7ab31750e03cf72467e9bf7c8a89bb8f4160b5d56def4cb24f595303bcdf065bf2ec7161c8165a6be7252b7cd8c3aa9bf9baf78690f19c1d4fc1d39e558bd4f4fdb3e56fb1b2e287cf67b0e0cf8df5c28c7bb94393cb837c180d380814a63e7db94e4e9652933e67f28f93dd92ee45be8f824cd9469dd0a872e130d4c1621a56d2a33ffb51c04b4151f0a471472a977d771b0eb13bf9fde44804ef755b97e1cae1e8d807f5eb692d7ffc20d8e451ce9ccd75b1a270836db80" } }, "commitments": { "type": "array", "items": { "type": "string", "description": "Represents the commitments.", "example": "2f7f341d6af9a75b317d0753d2fc0514baf38bb602cd66dc7d221aa371e6062c" } }, "macs": { "type": "array", "items": { "type": "string", "description": "Represents the macs.", "example": "52f677a49eb36bcce6b30f94bee481d73c4fdd61963bda54b68f3a90ca007b59" } }, "nullifiers": { "type": "array", "items": { "type": "string", "description": "Represents a sequence of nullifiers of the input notes.", "example": "30e41a9a6605933a75ec42439ab65eb347025002f6486e5549abb82438447dbe" } }, "oneTimePubKey": { "type": "string", "description": "Defines the one time public key.", "example": "0a2e7ba03903480af852cb47d8ce76eb6546aef69bdb35b28b8ae815012d4d13" }, "proof": { "type": "string", "description": "Defines the proof.", "example": "8dd9c988c9f337bd55c07fa9e2fa405cf4dda2cb915214fc0b5924870eed0f0187a0db001b5d8ea43a537e423d91d0fc868a456fa3e0bf9e99d1b04f43c6983a05a99458a69903add73ccaa4177844df9056d40c5a71ae14a70835cb30ca7d810fa1d48c9180ddec2ca1cecfaa8706ab514d6e8fe2dd228d7dc012d9407517523b774107a6a78dc972b175b94d1681b980e2b9ba7d39f880973787080a12bf14dc3f038333245a60bbcd9cb1fe2baba30ed083535752cc26ea0c57134e0c774e" }, "randomSeed": { "type": "string", "description": "Represents a 256-bit seed that must be chosen independently at random for each JoinSplit description.", "example": "05eb35ce1cec5f5824f708ee9d95467d2318d24c8d4220040df92d48b1f182e8" }, "vPubNew": { "type": "string", "description": "Defines the value that the joinSplit transfer will insert into the transparent transaction value pool", "example": "50.02989193" }, "vPubOld": { "type": "string", "description": "Defines the value that the joinSplit transfer will remove from the transparent transaction value pool.", "example": "0" } }, "required": [ "anchor", "cipherTexts", "commitments", "macs", "nullifiers", "oneTimePubKey", "proof", "randomSeed", "vPubNew", "vPubOld" ] } }, "vShieldedOutput": { "type": "array", "description": "Object Array representation of transaction output descriptions", "items": { "type": "object", "properties": { "cmu": { "type": "string", "description": "Represents the \ud835\udc62-coordinate of the note commitment for the output note.", "example": "4eb188a762d4fd4358ae70b2dac1b6a596ad653be92471792bf4b157850a1011" }, "cv": { "type": "string", "description": "Defines a value commitment to the value of the input note.", "example": "547a9cef4937304f97acacfcd9827b5aa1b2e5b1ae32e360fae828b955564a0e" }, "encCipherText": { "type": "string", "description": "Represents a ciphertext component for the encrypted output note.", "example": "a6c0084214eef0058f4b51c1e25b4c05ac282fec0edc5938c4283aa2a6d7c426d7a3c927d11596f81780b18c0eee90848702eb7fa512f7a6386e52d9bc17d5bc0e20bc24608ece560a314570aaf4c095bc988a9a0f8ef72ed91d0eee7d927eb37428c62af28c6a5c9379ac48aef3cdfb9b83eed77edde50acab7615f8fecdb1f24500fab6b8a72440e6fadbf0e6ad0ff8989df4d27bb2bc56c3a99c6da2e82c68a319857902842cf15aec180b6ea0ff3ebedf1cfd02b434ac715bc4afb17f67286d5708864a7aabb461461f080bbcf0315c38d782be6d0aae7ac3beb6574babf12c9182574d6c6e900888b5c4da40952c403b7d4ebe96e051893e388bcb7026d839e1d49ddbb132706fbadae1ef272d7e8dbf297dfbe7867651cfd843e52239d8270c1b6d46f2589643a5a325018f2d0b82b53955a5a3c5c3cecf8f0829594777887028456bd708c7c4ad88e588609c1b33d9060d8cf0015bfc18676ebc7022956ab6d4c6aae24550422e702733da234e2ce6f5adbafc4e2d97ae9846febddeacfaefda7f186b7e8182f4692c34bff4bd31eeeab15c5b5f7a41c93acae05a4f3c378fbe6cf33ab3628f4c5b8e04b9368ec69ea1c7c816c803d9ef7bbafe232f43959c7b49dd7c3328dc028040f440fd3cb2e08449db77c191288f120c065870d800ebdca234e6c2ba1fa6d44d04f4fed2e41b1c65d273b0ce58287274e8dc71a2a174244f026971bb9c698e7f7964eec615515910c627a201b52c3c2c504623ac45f5606d0400120bd5b6e1f431775fe92fb2c9eb5546c9dc12693ee9b679e49fce2cf71" }, "ephemeralKey": { "type": "string", "description": "Represents an encoding of an ephemeral Jubjub public key.", "example": "04c59e908296aeac1160ba8def90916988bf8389564343e6fb3b9e52c27fba0a" }, "outCipherText": { "type": "string", "description": "Represents a ciphertext component that allows the holder of the outgoing cipher key to recover the diversified transmission key pkd and ephemeral private key esk, hence the entire note plaintext.", "example": "b3f02b333a61b69e63dfeaf1ad430534985cd6958abe92664abe85449ca68b5c145f536e9a636a881aab5e314b4f550b2b8f5600dc1ed636f643b11e00bb6c469bf5205f16197372dcf5e4b0871e42f4" }, "proof": { "type": "string", "description": "Represents the proof.", "example": "8dd9c988c9f337bd55c07fa9e2fa405cf4dda2cb915214fc0b5924870eed0f0187a0db001b5d8ea43a537e423d91d0fc868a456fa3e0bf9e99d1b04f43c6983a05a99458a69903add73ccaa4177844df9056d40c5a71ae14a70835cb30ca7d810fa1d48c9180ddec2ca1cecfaa8706ab514d6e8fe2dd228d7dc012d9407517523b774107a6a78dc972b175b94d1681b980e2b9ba7d39f880973787080a12bf14dc3f038333245a60bbcd9cb1fe2baba30ed083535752cc26ea0c57134e0c774e" } }, "required": [ "cmu", "cv", "encCipherText", "ephemeralKey", "outCipherText", "proof" ] } }, "vShieldedSpend": { "type": "array", "description": "Object Array representation of transaction spend descriptions", "items": { "type": "object", "properties": { "anchor": { "type": "string", "description": "Defines a Merkle tree root of a note commitment tree which uniquely identifies a note commitment tree state given the assumed security properties of the Merkle tree\u2019s\r\nhash function.", "example": "d32ddbaf0d9dc8c10783c01fd9ba5bd0bc2e5efe3d1665d7d6771eb4393736b4" }, "cv": { "type": "string", "description": "Defines a value commitment to the value of the input note.", "example": "547a9cef4937304f97acacfcd9827b5aa1b2e5b1ae32e360fae828b955564a0e" }, "nullifier": { "type": "string", "description": "Represents a sequence of nullifiers of the input notes.", "example": "30e41a9a6605933a75ec42439ab65eb347025002f6486e5549abb82438447dbe" }, "proof": { "type": "string", "description": "Represents the proof.", "example": "030ff7fdb006db7f9acb0d2d6fae180e4395f0b6a979f6ddf48a349bc03ad2e7bb0324a5c3c7e6be131c34126ad22c74138f45f6f77bba706dfc87335a9adffcfef20a03e47751f403a37f9c5e1874aa50818c3eef09304c57c77b111057c09ed2112a7ed310ad285e0b778a4f44b654032b642b8b2df3be16bea011da7a2221bc0f0a0309f51f87caef2ea0f665f1a77d0dd50766d835d181e534818d8c3413b4d555990222574d9c92f81f17ff0af7a0583e76b3d3d4df2927561f37e57e15bc07b3f5d70306a9624c496d0bcb40085894bf32ef05db6469ec145c0ce5529e2697b6a0252c0216930cf7b3a7381762a6a91868e9d2bf823bfc7fb885de1fbd6a6cacae02db590318ffeb357ffd6832893ab0ccd3b15cef1df0fef45c091cf33fccee43a2834d44" }, "rk": { "type": "string", "description": "Represents the randomized validating key for spendAuthSig.", "example": "39bdf742e16c4d1533a56df956bebe4d0214d4a361820db58a293847b6344d30" }, "spendAuthSig": { "type": "string", "description": "Used to prove knowledge of the spending key authorizing spending of an input note.", "example": "0f3b38a91fffbbf58f99d2d070002c0868be6804204b7bf4be0df47f62ee5e0d43222776a71fd7e1421ec54502194192d73681701b743ad427573ca18a95a405" } }, "required": [ "anchor", "cv", "nullifier", "proof", "rk", "spendAuthSig" ] } }, "valueBalance": { "type": "string", "description": "String representation of the transaction value balance", "example": "0" }, "version": { "type": "integer", "description": "Represents the transaction version number.", "example": 1 }, "versionGroupId": { "type": "string", "description": "Represents the transaction version group ID.", "example": "0x892f2085" }, "vin": { "type": "array", "description": "Object Array representation of transaction inputs", "items": { "type": "object", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send/receive the amount.", "example": "t2UNzUUx8mWBCRYPRezvA363EYXyEpHokyi" } }, "scriptSig": { "type": "object", "description": "Specifies the required signatures.", "properties": { "asm": { "type": "string", "description": "The asm strands for assembly, which is the symbolic representation of the Bitcoin's Script language op-codes.", "example": "OP_HASH160 ef775f1f997f122a062fff1a2d7443abd1f9c642 OP_EQUAL" }, "hex": { "type": "string", "description": "Represents the hex of the public key of the address.", "example": "a914ef775f1f997f122a062fff1a2d7443abd1f9c64287" }, "type": { "type": "string", "description": "Represents the script type of the reference transaction identifier.", "example": "pubkeyhash" } }, "required": [ "asm", "hex", "type" ] }, "sequence": { "type": "integer", "format": "int64", "description": "Represents the script sequence number.", "example": 4294967295 }, "txid": { "type": "string", "description": "Represents the reference transaction identifier.", "example": "4b66461bf88b61e1e4326356534c135129defb504c7acb2fd6c92697d79eb250" }, "txinwitness": { "type": "array", "items": { "type": "string", "description": "Represents an array hex-encoded witness data (if there is any) as strings.", "example": "3045022100c11ea5740bcd69f0f68a4914279838014d28923134d18e05c5a5486dfd06cc8c02200dadccec3f07bed0d1040f9e5a155efa5fdd40fc91f92342578d26848da4c6b901" } }, "value": { "type": "string", "description": "Defines the specific amount.", "example": "0.000144" }, "vout": { "type": "integer", "description": "It refers to the index of the output address of this transaction. The index starts from 0.", "example": 1 } }, "required": [ "addresses", "scriptSig", "sequence", "txid", "value", "vout" ] } }, "vout": { "type": "array", "description": "Object Array representation of transaction outputs", "items": { "type": "object", "properties": { "isSpent": { "type": "boolean", "description": "Defines whether the transaction output has been spent or not.", "example": true }, "scriptPubKey": { "type": "object", "description": "Object representation of the script", "properties": { "addresses": { "type": "array", "items": { "type": "string", "description": "Represents the addresses which send the amount.", "example": "t2UNzUUx8mWBCRYPRezvA363EYXyEpHokyi" } }, "asm": { "type": "string", "description": "Represents the assembly of the script public key of the address.", "example": "OP_HASH160 ef775f1f997f122a062fff1a2d7443abd1f9c642 OP_EQUAL" }, "hex": { "type": "string", "description": "Represents the hex of the script public key of the address.", "example": "a914ef775f1f997f122a062fff1a2d7443abd1f9c64287" }, "reqSigs": { "type": "integer", "description": "Represents the required signatures.", "example": 1 }, "type": { "type": "string", "description": "Represents the script type.", "example": "pubkeyhash" } }, "required": [ "addresses", "asm", "hex", "type" ] }, "value": { "type": "string", "description": "Represents the specific amount.", "example": "0.000144" } }, "required": [ "isSpent", "scriptPubKey", "value" ] } } }, "description": "Zcash", "required": [ "bindingSig", "expiryHeight", "joinSplitPubKey", "joinSplitSig", "locktime", "overwintered", "size", "valueBalance", "version", "versionGroupId", "vin", "vout" ] }, "GetVaultTransactionDetailsByTransactionIDRIBSBSC": { "type": "object", "properties": { "contract": { "type": "string", "description": "Represents the specific transaction contract", "example": "0x0000000000000000000000000000000000001000" }, "gasLimit": { "type": "string", "description": "Represents the amount of gas used by this specific transaction alone.", "example": "21000" }, "gasPrice": { "type": "object", "properties": { "amount": { "type": "string", "description": "Represents the price offered to the miner to purchase this amount of gas.", "example": "20000000000" }, "unit": { "type": "string", "description": "Defines the unit of the gas price amount, e.g. BTC, ETH, XRP.", "example": "BNB" } }, "required": [ "amount", "unit" ] }, "gasUsed": { "type": "string", "description": "Defines the unit of the gas price amount, e.g. BTC, ETH, XRP.", "example": "21000" }, "inputData": { "type": "string", "description": "Represents additional information that is required for the transaction.", "example": "0x" }, "nonce": { "type": "integer", "description": "Represents the sequential running number for an address, starting from 0 for the first transaction. E.g., if the nonce of a transaction is 10, it would be the 11th transaction sent from the sender's address.", "example": 25341 } }, "description": "Binance Smart Chain", "required": [ "contract", "gasLimit", "gasPrice", "gasUsed", "inputData", "nonce" ] }, "GetVaultTransactionDetailsByTransactionIDRIBST": { "type": "object", "properties": { "amount": { "type": "string", "description": "String representation of the amount value" }, "bandwidthUsed": { "type": "string", "description": "Numeric representation of the transaction used bandwidth" }, "contract": { "type": "string", "description": "Numeric representation of the transaction contract" }, "energyUsed": { "type": "string", "description": "String representation of the transaction used energy" }, "hasInternalTransactions": { "type": "boolean" }, "hasTokenTransfers": { "type": "boolean" }, "input": { "type": "string", "description": "Numeric representation of the transaction input" }, "status": { "type": "string", "description": "String representation of the transaction status" } }, "description": "Tron", "required": [ "amount", "bandwidthUsed", "contract", "energyUsed", "hasInternalTransactions", "hasTokenTransfers", "input", "status" ] }, "GetVaultTransactionDetailsByTransactionIDRI": { "type": "object", "properties": { "isConfirmed": { "type": "boolean", "description": "Represents the state of the transaction whether it is confirmed or not confirmed.", "example": true }, "transactionId": { "type": "string", "description": "Represents the unique identifier of a transaction, i.e. it could be `transactionId` in UTXO-based protocols like Bitcoin, and transaction `hash` in Ethereum blockchain.", "example": "3e081861494aed897e589cdeab5d9e628d985e571ed1c19896d1aa698cce9d80" }, "index": { "type": "integer", "description": "Represents the index position of the transaction in the specific block.", "example": 21 }, "minedInBlockHash": { "type": "string", "description": "Represents the hash of the block where this transaction was mined/confirmed for first time. The hash is defined as a cryptographic digital fingerprint made by hashing the block header twice through the SHA256 algorithm.", "example": "0000000000503b5200a935cfa9e7740783b5f2292aaad3bf273554abfb3d91ce" }, "minedInBlockHeight": { "type": "integer", "description": "Represents the hight of the block where this transaction was mined/confirmed for first time. The height is defined as the number of blocks in the blockchain preceding this specific block.", "example": 1250283 }, "recipients": { "type": "array", "description": "Object Array representation of transaction receivers", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "String representation of the receiver address", "example": "tb1q7xnacwu6nzamkggg6nzedr4jux8t7u9f3ltvus" }, "amount": { "type": "string", "description": "String representation of the amount", "example": "0.01745343" } } } }, "senders": { "type": "array", "description": "String representation of the transaction from address", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "String array representation of the sender address", "example": "tb1qq6qq5kynmzsvt9m6e56qd6xd4zd48xzcjwuyt3" }, "amount": { "type": "string", "description": "String representation of the amount", "example": "0.01822484" } } } }, "timestamp": { "type": "integer", "description": "Defines the exact date/time in Unix Timestamp when this transaction was mined, confirmed or first seen in Mempool, if it is unconfirmed.", "example": 1636972451 }, "transactionHash": { "type": "string", "description": "Represents the same as `transactionId` for account-based protocols like Ethereum, while it could be different in UTXO-based protocols like Bitcoin. E.g., in UTXO-based protocols `hash` is different from `transactionId` for SegWit transactions.", "example": "c58148bb37b9be020338e427784580b58e0b497ce32d7eddf812de6a1a0d3133" }, "fee": { "type": "object", "properties": { "amount": { "type": "string", "description": "When isConfirmed is True - Defines the amount of the transaction fee\r\nWhen isConfirmed is False - For ETH-based blockchains this attribute represents the max fee value.", "example": "0.00003812" }, "unit": { "type": "string", "description": "Represents the unit of the fee.", "example": "BTC" } }, "required": [ "amount", "unit" ] }, "blockchainSpecific": { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBS" } }, "required": [ "isConfirmed", "transactionId", "index", "recipients", "senders", "timestamp", "transactionHash", "fee", "blockchainSpecific" ] }, "GetVaultTransactionDetailsByTransactionIDRIBS": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSB" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSE" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSL" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSBC" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSEC" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSD" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSD2" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSZ" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBSBSC" }, { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRIBST" } ] }, "GetVaultTransactionDetailsByTransactionIDR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "GetVaultTransactionDetailsByTransactionIDE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "GetVaultTransactionDetailsByTransactionIDE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "GetVaultTransactionDetailsByTransactionIDE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" } ] }, "ValidateAddressRI": { "type": "object", "properties": { "address": { "type": "string", "description": "Represents the specific address that will be checked if it's valid or not.", "example": "15XyNC88pujwuuur8DCsXBCfEhJJMzHayU" }, "isValid": { "type": "boolean", "description": "Defines whether the address is valid or not. Set as boolean.", "example": true } }, "required": [ "address", "isValid" ] }, "ValidateAddressR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "item": { "$ref": "#/components/schemas/ValidateAddressRI" } }, "required": [ "item" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "ValidateAddressE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "ValidateAddressE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "ValidateAddressE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" } ] }, "ListVaultsRI": { "type": "object", "properties": { "backuped": { "type": "boolean", "description": "Represents whether the Vault is backuped.", "example": true }, "id": { "type": "string", "description": "Defines the unique ID of the Vault.", "example": "64d0d39df6762400071440c3" }, "name": { "type": "string", "description": "Defines the name of the Vault given to it by the user.", "example": "test vault" }, "type": { "type": "string", "description": "Represents the type of the Vault.", "example": "test", "enum": [ "main", "test" ] } }, "required": [ "backuped", "id", "name", "type" ] }, "ListVaultsR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, "offset": { "type": "integer", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 }, "total": { "type": "integer", "description": "Defines the total number of items returned in the response.", "example": 100 }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/ListVaultsRI" }, "example": [] } }, "required": [ "limit", "items", "offset", "total" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "ListVaultsE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "ListVaultsE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "ListVaultsE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" } ] }, "ListSupportedTokensRI": { "type": "object", "properties": { "decimals": { "type": "integer", "description": "Defines the token's decimal number or all of its points after the zero.", "example": 6 }, "identifier": { "type": "string", "description": "Represents a unique identifier for the specific blockchain and network, e.g. smart contract address, property ID, etc.", "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" }, "name": { "type": "string", "description": "Defines the token name.", "example": "Tether" }, "symbol": { "type": "string", "description": "Defines the token's unique symbol in the Vaultody listings.", "example": "USDT" }, "type": { "type": "string", "description": "Represents the token's type representation, e.g. ERC-20, Omni, etc..", "example": "ERC-20" } }, "required": [ "decimals", "identifier", "name", "symbol", "type" ] }, "ListSupportedTokensR": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "data": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, "offset": { "type": "integer", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 }, "total": { "type": "integer", "description": "Defines the total number of items returned in the response.", "example": 100 }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/ListSupportedTokensRI" }, "example": [] } }, "required": [ "limit", "items", "offset", "total" ] } }, "required": [ "apiVersion", "requestId", "data" ] }, "ListSupportedTokensE401": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/MissingApiKey" }, { "$ref": "#/components/schemas/InvalidApiKey" } ] }, "ListSupportedTokensE400": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/UriNotFound" }, { "$ref": "#/components/schemas/LimitGreaterThanAllowed" }, { "$ref": "#/components/schemas/InvalidPagination" } ] }, "ListSupportedTokensE403": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/BannedIpAddress" }, { "$ref": "#/components/schemas/EndpointNotAllowedForPlan" }, { "$ref": "#/components/schemas/EndpointNotAllowedForApiKey" }, { "$ref": "#/components/schemas/FeatureMainnetsNotAllowedForPlan" } ] } } }, "security": [ { "ApiKey": [], "ApiSign": [], "ApiTimestamp": [], "ApiPassphrase": [] } ], "info": { "title": "Vaultody", "version": "2023-04-20", "description": "Vaultody", "termsOfService": "https://vaultody.com/terms-conditions", "contact": { "name": "Vaultody Team", "url": "https://vaultody.com/", "email": "developers@vaultody.com" }, "license": { "name": "MIT", "url": "http://www.opensource.org/licenses/mit-license.php" } }, "tags": [ { "name": "Getting Started", "description": "## Introduction\r\n\r\nVaultody is a platform that offers a suite of secure storage and management solutions for digital assets. The Vaultody platform includes a range of APIs (Application Programming Interfaces) and SDKs (Software Development Kits) that allow developers to integrate digital asset storage and management functionality into their applications and systems.\r\n\r\nThe technical documentation for Vaultody provides developers with a comprehensive overview of the platform's APIs, SDKs, and other tools, including their functionality, usage, and integration requirements. The documentation covers a range of topics, including digital asset storage and management protocols, secure key management, and multi-factor authentication.\r\n\r\nYou can download our OpenAPI 3.0 Specification as the latest JSON from [here](https://developers.vaultody.com/download-latest-json).\r\n\r\n{warning}This documentation and all API References apply **only** to Vaultody.{/warning}\r\n\r\n\r\n## Supported Protocols and Networks\r\n\r\nVaultody's support for a wide range of digital assets makes it an ideal platform for developers and businesses looking to securely store and manage their digital assets. The platform is designed to support a variety of blockchain protocols and is constantly updating to support new assets as they become available. [Supported Protocols](https://vaultody.com/integrations/protocols). \r\n\r\n\r\n## Vaultody APIs Versioning\r\nAn additional feature in the Vaultody APIs system allows us to generate new API versions of our endpoints each time backwards-incompatible changes have been made to them. Versions are generally titled with a date and \"stable\" versions are marked as such.\r\nYou can try out new features and changes in our newer versions not marked as \"stable\".\r\nOur technical documentation lists all available API versions. To view a specific one, select it from the drop down menu.\r\nAll requests use your account's API version, unless you override the API version with a header.\r\n\r\n## Choose SDK\r\n\r\nVaultody Technical Documentation has included vast and detailed information regarding the use of its API services. Additionally, we have prepared various SDKs to help you get quickly started.\r\n\r\nYou can pick one of our current SDK\u2019s [here](https://developers.vaultody.com/sdk-libraries).\r\n\r\n## What are the benefits of using SDK libraries?\r\n\r\nUsing SDK libraries can offer several benefits to developers, including:\r\n\r\nSDK libraries are pre-built code modules that simplify application development by reducing the time and effort needed to develop complex functionality from scratch. These libraries ensure consistency in coding practices and interface design as they are created and maintained by the platform or framework provider. They are thoroughly tested and optimized, increasing the reliability and stability of the code used in the application. SDK libraries provide a standardized way of interacting with a platform or framework, which makes it easier to integrate with other software components or systems. Moreover, they come with comprehensive documentation, such as usage guides, reference documentation, and examples, making it easier for developers to understand and use the library effectively.\r\n\r\n## The Dashboard\r\nOnce you create an account, you get access to a personalized Vaultody [Dashboard](https://my.vaultody.com/). \r\n\r\nFrom the Dashboard you can:\r\n\r\n- Creating wallets\r\n- Generating deposit addresses\r\n- Creating transaction requests\r\n- Managing funds\r\n- Performing account-related actions\r\n- Accessing specific features or functionalities of an API\r\n- Create API key with specific access\r\n\r\n## Authenticate requests\r\n\r\nTo use and make calls to Vaultody, you must create an API key, in order for your requests to be authenticated.\r\n\r\nAn API key is a code unique to the user who generated it. It is used to identify the call to the specific API and track the access to it and its usage. You can generate your API key from within the Vaultody [dashboard](https://my.vaultody.com/) by clicking on the \u201cCreate new API key\u201d button. You can generate more than one API key and use a single API key more than once.\r\n\r\nFor more information on Authenticating requests, please see [\u201cAuthentication\u201d](https://developers.vaultody.com/technical-documentation/api/general-information/authentication) section." }, { "name": "Authentication", "description": "## Create API key\r\n\r\nThe Advanced API Key Permissions feature allows you to manage access to specific functionalities of API keys. To set this up, you need to decide on the permissions you want to assign to the key during the creation.\r\n\r\nYou can generate and manage API keys from within the Vaultody APIs Dashboard [here](https://my.vaultody.com/). By clicking on \u201cCreate new API key\u201d you can enter a name and the system will generate a unique for your user key for API authentication. Multiple keys can be generated. Old API keys, that you no longer want to use, can be deleted from the same location.\r\n\r\n## Use API key\r\n\r\nVaultody requires you to create an API key through the Dashboard website to sign a request. When creating a key, you should keep a record of (1) the key, (2) the secret, and (3) the passphrase, which is of your choice and adds an extra layer of security to your API access.\r\n\r\nTo sign a message, you need to generate the X-API-SIGN header by creating a sha256 HMAC using the secret key in base64-decoded format on the prehash string timestamp + method + requestPath + body + query. The output is then base64-encoded.\r\n\r\nExample:\r\n\r\n```\r\n// import crypto library\r\nconst crypto = require('crypto');\r\n\r\n// create the request object\r\nconst timestamp = Math.floor(new Date().getTime() / 1000); // in seconds\r\nconst secret = 'hry/KLGI5cDYzA==';\r\nconst method = 'POST';\r\nconst requestPath = '/transactions';\r\nconst body = JSON.stringify({\r\n amount: '200',\r\n address: '0xE874F9DA2e4702A19c1003Bc87BD47eC739DdcBC',\r\n walletId: '612e298ad4bd22000791b455'\r\n});\r\n\r\nconst query = JSON.stringify({}); // stringify the query parameters if there are any\r\n\r\n// prepare the prehash string by concatenating the required parts\r\nconst message = timestamp + method + requestPath + body + query;\r\n\r\n// decode the base64 secret\r\nconst key = Buffer.from(secret, 'base64');\r\n\r\n// create a sha256 hmac with the secret\r\nconst hmac = crypto.createHmac('sha256', key);\r\n\r\n// sign the request message with the hmac and base64 encode the result\r\nconst sign = hmac.update(message).digest('base64');\r\n```\r\n\r\n{note}The variable requestPath should only contain the path part of the URL without any query parameters.{/note}\r\n\r\nExample: requestPath /wallet-as-a-service/info/tron/mainnet/supported-tokens\r\n\r\n{note}The query string JSON should only contain string values for its attributes.{/note}\r\n\r\nExample: query = {'context': 'yourExampleString', 'limit': '50', 'offset': '0'}\r\n\r\n{note}The X-API-TIMESTAMP header is required to be in UTC format and must represent the number of seconds since Unix Epoch. Decimal values are allowed.{/note}\r\n\r\n`const timestamp = Math.floor(new Date().getTime() / 1000); // in seconds``\r\n\r\nIt is crucial to ensure that your timestamp is within 30 seconds of the API service time; otherwise, your request will be considered expired and rejected. You can query the time endpoint to determine if there is a time difference between your server and the API servers.\r\n\r\nAll REST requests should contain the following headers:\r\n\r\nX-API-KEY: API key as a string\r\n\r\nX-API-SIGN: base64-encoded signature (see Signing a Message)\r\n\r\nX-API-TIMESTAMP: Timestamp for your request\r\n\r\nX-API-PASSPHRASE: Passphrase you specified when creating the API key\r\n\r\n{warning}It's important to secure your API Key against public access. The custom header option is strongly recommended for a production environment.{/warning}" }, { "name": "Data Flow Limiting", "description": "### Enabled features\r\n\r\nAt Vaultody APIs, the features available in each subscription tier determine the data flow limit. Our blockchain-related API products offer a range of options, with higher subscription tiers providing more advanced features to meet your needs and preferences.\r\n\r\nFor more information on our subscription plans and pricing, please do not hesitate to [contact us](https://vaultody.com/request-access). \r\n\r\n### Using Pagination\r\n\r\nWhen making calls to the Vaultody APIs, a large number of results can be expected in the response. Blockchains consist of hundreds of thousands of data blocks at the least, containing hashed information on transactions which can add up to hundreds and more pages of information when called. To ensure the normal flow and structure of the results of the API response and optimize our efficiency, we paginate our results. Paginated results are returned usually to a GET request. \r\n\r\n\r\n_**Example:**_\r\n\r\n```\r\n{\r\n \"apiVersion\": \"2.0\",\r\n \"requestId\": \"xxxxxxxxxxxx\",\r\n \"data\": {\r\n \"offset\": 0,\r\n \"limit\": 50,\r\n \"total\": 2,\r\n \"items\": [\r\n {\r\n //item 1\r\n },\r\n {\r\n //item 2\r\n }\r\n ]\r\n }\r\n}\r\n\r\n```\r\n\r\nTo avoid requests that may potentially crash the system or result in an error, we have set up a default limit on results with the value `limit`: 50. This means that regardless of the value of the property `total` in the response, by default only 50 can be displayed at a time. The default value of the `limit` property is set to \"50\", but can vary or be modified depending on the specific List endpoint.\r\n\r\nTo see how many items in total your request can return in general, see the value `total`. Depending on that number (if it is higher than the default `offset`: 50) and your preferences, you can send another request to fetch the next segment of the results again displayed within the default 50 items per page limit.\r\n\r\n\r\n### How do I know whether a certain endpoint uses pagination?\r\n\r\nThe process of pagination requires a request that would return a response of multiple items, or a list. When information is listed then It requires sorting and limiting of display. \r\n\r\nEndpoints that request information on a specific item - address, transaction, block, etc., will return a single count of the requested item, along with its respected details, which are the goal of the request. \r\n\r\n_**Example:**_\r\n\r\nThis is a response example for a request to GET address details. The value `item` being in the singular form, due to the request fetching information on one item, indicates there is no pagination for the specific endpoint.\r\n\r\n```\r\n{\r\n \"apiVersion\": \"2.0\",\r\n \"requestId\": \"xxxxxxxxxxxx\",\r\n \"address\": \"xxxxxxxxxxxx\",\r\n \"data\": {\r\n \"limit\": 0,\r\n \"offset\": 50,\r\n \"total\": 1,\r\n \"item\": [\r\n {\r\n //address details\r\n }\r\n ]\r\n }\r\n}\r\n\r\n```\r\n\r\n_**Example:**_\r\n\r\nThe following is a different response example for a request to GET a list of addresses by a certain attribute. The value `items` is in the plural form, which indicates that the response includes more than one count of the requested information, which makes it a list. Ergo, this specific endpoint uses pagination.\r\n\r\n```\r\n{\r\n \"apiVersion\": \"2.0\",\r\n \"requestId\": \"xxxxxxxxxxxx\",\r\n \"data\": {\r\n \"limit\": 0,\r\n \"offset\": 50,\r\n \"total\": 1000,\r\n \"items\": [\r\n {\r\n //address 1\r\n },\r\n {\r\n //address 2\r\n },\r\n\t{\r\n\t \u2026\r\n\t}\r\n ]\r\n }\r\n}\r\n\r\n```\r\n\r\n### How do I see the next page of the response?\r\n\r\nVaultody APIs obtains information from the blockchain database, therefore a new request has to be made in order to see further items from the response. The next response will still be limited to the default pagination value `offset`: 50, but you can get the next page by modifying the `limit` value.\r\n\r\n`limit` indicates from which item in the list should the response start displaying results. The first paginated response of a request will by default start count from 0, i.e. `limit`: 0. By modifying this value you can retrieve the next segment of the results again displayed within the default 50 items per page limit.\r\n\r\n_**Example:**_\r\n\r\n```\r\n{\r\n \"apiVersion\": \"2.0\",\r\n \"requestId\": \"xxxxxxxxxxxx\",\r\n \"data\": {\r\n \"limit\": 51,\r\n \"offset\": 50,\r\n \"total\": 1000,\r\n \"items\": [\r\n {\r\n //address 51\r\n },\r\n {\r\n //address 52\r\n },\r\n\t{\r\n\t \u2026\r\n\t}\r\n ]\r\n }\r\n}\r\n\r\n```\r\n\r\nTo retrieve every segment of the response, in order to view all possible results, you have to each time make a new request with a modified `limit`. The default `offset` value cannot be modified to be more or less than 50." }, { "name": "Standards Conventions and Versioning", "description": "## Standards and Conventions\r\n\r\nThis article will present and describe principles, standards and conventions we apply to our APIs and processes. The following information may be subject to change and may as well not apply to other software.\r\n\r\nWe use OpenAPI 3 Standard for our Technical Documentation and Endpoints description. All Technical Documentation can be found in the [Developer\u2019s Portal](https://developers.vaultody.com/technical-documentation). Moreover, all Vaultody endpoints are REST.\r\n\r\n## Vaultody Versioning\r\nAn additional feature in the Vaultody system allows us to generate new API versions of our endpoints each time backwards-incompatible changes have been made to them. Versions are generally titled with a date and \"stable\" versions are marked as such.\r\nYou can try out new features and changes in our newer versions not marked as \"stable\".\r\nOur technical documentation lists all available API versions. To view a specific one, select it from the drop down menu.\r\nAll requests use your account's API version, unless you override the API version with a header.\r\n\r\n## URI\r\n\r\n### URI Structure\r\n\r\nThe Vaultdoy and endpoint URIs follow the RFC 3986 specification and are divided into two main parts, applicable to all Vaultody endpoints : The domain and subdomain in the URI always display as: **rest.vaultody.com\r\n\r\n1. The domain and subdomain in the URI always display as: **rest.vaultody.com**\r\n2. Next is displayed the product name, where words are separated with spinal-case: **/wallet-as-a-service/**\r\n\r\n### URI Naming Standards\r\n\r\nURIs have to follow the naming standards as listed below:\r\n\r\n- the URI has to be written in all lower cases, except when a specific string requires capital letters;\r\n- the path parameter must use spinal-case ( a hyphen - ) to separate words, e.g. **/wallet-as-a-service**;\r\n- the query parameters must use camelCase to differentiate words, e.g. **/wallet-as-a-service/bitcoin/addresses?offset=10&limit=0**;\r\n- the variables must use camelCase to differentiate words, e.g. **/wallet-as-a-service/bitcoin/addresses/${bitcoinValidAddress}**;\r\n- all URLs must be **HTTPS** - secured, using only HTTP is not accepted.\r\n\r\n\r\n### URI Maximum Length\r\n\r\nThe entire URI cannot exceed 2000 characters in length including any punctuation marks, e.g. commas, hyphens, question marks, pluses or forward slashes.\r\n\r\n\r\n## Request and Response Standards\r\n\r\n### Basic API Request \r\n\r\nMain prerequisites for requests to the Vaultody APIs include:\r\n\r\n- requests are sent through HTTPS only to the domain **rest.vaultody.com**;\r\n- headers must by default incorporate the JSON content type **application/json**;\r\n- all custom for Vaultody attributes are indicated in the beginning with an `x-`, e.g. `x-attribute`;\r\n- request public attributes must be all camelCase, e.g. `\"attributeName\": \"attributeValue\"`;\r\n- we enable CORS (Cross-Origin Resource Sharing), for which the API responds with an `Access-Control-Allow-Origin:` header. **Nevertheless**, your users **shouldn\u2019t make** direct API requests from a web application that you are building, as our CORS policy may change at some point without warning and any such requests could be then rejected;\r\n- no random unspecified keys can be added to the Vaultdoy URI, e.g. `?randomKey=randomUnspecifiedValue`, as that will result in a 400 error;\r\n- all requests to the Vaultody **must** be authenticated with an API key. Owner can generate API keys through the dedicated [Dashboards](https://my.vaultody.com/) only after product subscription. Multiple API keys can be generated. \r\n- API keys must be kept secure and private by the users who own them. API keys **must not** be uploaded to a frontend of a mobile or web application or in any open source code, as API keys represent access to the user\u2019s account and the data inside.\r\n\r\n{tip}Best to use one API key for testing and integration purposes, and a separate one for production, known to only a limited number of people.{/tip}\r\n\r\nShortly put, all Vaultdoy API requests include:\r\n\r\n```\r\nREST API Base URL: https://rest.vaultody.com\r\nAuthentication (API Key + JSON)\r\nRequest Type (GET, POST, PUT, PATCH, DELETE)\r\n```\r\n\r\nOur API Requests incorporate the following HTTP methods:\r\n\r\n| HTTP method | Definition |\r\n|:---:|:---:|\r\n| GET | Retrieve a specified resource/information from the server. |\r\n| POST | Send data to the server and requests to accept it. |\r\n| PUT | Updates a resource. |\r\n| PATCH | Partially updates a resource. |\r\n| DELETE | Deletes a resource. |\r\n\r\n**POST** requests always contain the following body structure:\r\n\r\n\r\n```\r\n{\r\n\t\"context\": \"You can add any text here.\", // Optional: In case you send this value in the request.\r\n\t\"data\": { // Contains the request parameters.\r\n\t\t\"item\": { // Single item\u2019s details.\r\n\t\t\t\"endpointAttribute\": \"value\" // Parameter data.\r\n\t\t}\r\n\t}\r\n}\r\n```\r\n\r\nIf an endpoint has no parameters, the body structure has less data:\r\n\r\n```\r\n{\r\n\t\"context\": \"You can add any text here\", // Optional: In case you send this value in the request.\r\n\t\"data\": { // Contains the request parameters.\r\n\t\t\"item\": { } // Single item\u2019s details.\r\n\t}\r\n}\r\n```\r\n\r\n\r\n\r\n### Basic API Response\r\n\r\nResponses to Vaultody APIs requests prerequisites: \r\n\r\n- response public attributes must be all camelCase, e.g. `\u201dapiVersion\u201d: 2`, `\u201dcustomAttribute\u201d: \"customAttribute\"`;\r\n- Vaultody APIs requests always return the following parameters:\r\n\r\n```\r\n{\r\n \"requestId\": \"\",\r\n \"context\": \"\",\r\n \"data\": {\r\n \"item\": {\r\n }\r\n }\r\n}\r\n```\r\n\r\n- `requestId` is a unique code used with the purposes of tracking, support, etc.;\r\n- the attribute `data` always contains the result, no matter of the quantity of items in it;\r\n- the attribute `item` specifies the response\u2019s result indicating there is only a single one, when listed as `items` it means there are two or more results, i.e. a list of results, in the response;\r\n- all calculated prices are always in USD currency;\r\n- we use pagination methods to limit the results in the response, specifically on responses that can potentially return hundreds or thousands of results, please see more information in our [Data Flow Limiting section](https://developers.vaultody.com/technical-documentation/api/general-information/data-flow-limiting).\r\n\r\n\r\n### The `context` parameter\r\n\r\nThe `context` parameter is an optional attribute created with the idea to facilitate users when they make requests in bulk.\r\n\r\nThey can set the `context` attribute as a string with simple text of their choosing. Afterwards each returned information will contain the specific `context` string of its associated request. Through this process users can keep track of the responses that come in.\r\n\r\nFor **GET** requests the attribute can be set as a query parameter. For **POST** requests it can be set as a query or body parameter. In the latter scenario there\u2019s a safety measure embedded in case the user sets `context` as both a query and body parameter - the system will then take into account the body `context` attribute.\r\n\r\n\r\n\r\n## Error and HTTP Code Standards\r\n\r\nThe page below contains a comprehensive compilation of errors.\r\n\r\nThe errors we use follow the HTTP Error Codes Standard. \r\n\r\n| HTTP Status Code | Error it represents |\r\n|:---:|:---:|\r\n|3xx | Redirection Error |\r\n|4xx | Client Error |\r\n|5xx | Server Error |\r\n\r\n\r\nThe structure of the error **always** returns the following values, as listed and described in the example:\r\n\r\n\r\n_**Example:**_\r\n\r\n```\r\n{\r\n \"requestId\": \"\", // Each request has a unique ID, for which the Support team could ask for when contacted.\r\n \"context\": \"\", // Optional: In case you send this value in your request.\r\n \"error\": {\r\n \"code\": \"\", // Error Code, please check our [Errors page](https://developers.vaultody.com/technical-documentation/general-information) to see the full list of error codes.\r\n \"message\": \"\", // Is the human readable error message.\r\n \"details\": \"\" // Optional: Some errors may need more details.\r\n }\r\n}\r\n```\r\n\r\n## List of errors\r\n\r\nAll requests with a response status code different than 200 (successful HTTP) are considered as a failure of the particular API call and referred to as \u201cHTTPS errors\u201d. When the response (error) is returned an additional JSON is present in the body containing the error message. Depending on what has gone wrong with the API call, the error message is different.\r\n\r\nAs best practice we recommend to store all error messages somewhere along with request data for further manual review.\r\n\r\nThe errors we use follow the HTTP Error Codes Standard. \r\n\r\n| HTTP Status Code | Error it represents |\r\n|:---:|:---:|\r\n|3xx | Redirection Error |\r\n|4xx | Client Error |\r\n|5xx | Server Error |\r\n\r\n\r\nThe structure of the error **always** returns the following values, as listed and described in the example:\r\n\r\n\r\n_**Example:**_\r\n\r\n```\r\n{\r\n \"apiVersion\": \"\", // The current API Version.\r\n \"requestId\": \"\", // Each request has a unique ID, for which the Support team could ask for when contacted.\r\n \"context\": \"\", // Optional: In case you send this value in your request.\r\n \"error\": {\r\n \"code\": \"\", // Error Code, please check our [Errors page](https://developers.vaultody.com/technical-documentation/api/general-information) to see the full list of error codes.\r\n \"message\": \"\", // Is the human readable error message.\r\n \"details\": \"\" // Optional: Some errors may need more details.\r\n }\r\n}\r\n```\r\n\r\nWe use the following error codes:\r\n\r\n\r\n### General errors\r\n\r\n| Type of code | HTTP Status Code | Error code | Message |\r\n| :---: | :---: | :---: | :---: |\r\n| Client Error | 400 | `uri_not_found` | \"The specified URI has not been found. Check the URI and try again.\" |\r\n| | | `limit_greater_than_allowed` | \"You have reached the allowed limit. The maximum number of items for this endpoint is {limit}, please use the specific pagination attributes to get the items in portions.\" |\r\n| | | `invalid_pagination` | \"The pagination attributes that have been used are invalid. Please check the Documentation to see details on pagination.\" |\r\n| | 401 | `missing_api_key` | \"The specific authorization header (API Key) is missing, please check our Authorization section in our Documentation.\" |\r\n| | | `invalid_api_key` | \"The provided API key is invalid. Please, generate a new one from your Dashboard.\u201d |\r\n| | 403 | `https_required` | \"The use of HTTP**S** is required.\" |\r\n| | | `endpoint_not_allowed_for_plan` | \"This endpoint is not available for your current subscription plan, please upgrade your plan to be able to use it.\" |\r\n| | | `data_not_allowed_for_plan` | \"Your subscription plan includes only {days} days of historical data. Please upgrade your plan or contact our team for more information.\" |\r\n| | | `banned_ip_address` | \"This IP address has been banned. To check the reason for that, please contact our team via email.\" |\r\n| | | `endpoint_not_allowed_for_api_key` | \u201cThis endpoint is not available for your API key.\u201d |\r\n| | 404 | `resource_not_found` | \"The specified resource has not been found.\" |\r\n| | 405 | `request_method_not_supported` | \"The specified request method ({method}) is not supported for this endpoint. Please check our Documentation and make sure you set the right request method.\" |\r\n| | | `allowed_methods` | \"The specified method **must** be one of the following: {methods}.\" |\r\n| | 409 | `invalid_query_parameter` | \"The query parameter provided is invalid. Please provide a proper query parameter, or refer to the documentation for more information.\" |\r\n| | | `missing_request_body` | \"The required request body is missing, action cannot be performed.\" |\r\n| | | `bad_json` | \"The JSON provided is invalid. Please make sure it's valid and try again.\" |\r\n| | | `invalid_data` | \"The data provided seems to be invalid.\" |\r\n| | | `already_exists` | \"The specified resource already exists.\" |\r\n| | | `missing_required_attributes` | \"A required parameter is missing. Please provide all required parameters, or refer to the documentation for more information.\" |\r\n| | | `extra_body_attributes` | \"A provided body parameter is unknown or not specified. Please provide only specified body parameters, or refer to the documentation for more information.\" |\r\n| | | `extra_query_attributes` | \"A provided query parameter is unknown or not specified. Please provide only specified query parameters, or refer to the documentation for more information.\" |\r\n| | 415 | `unsupported_media_type` | \"The selected Media Type is unavailable. The Content-Type header should be 'application/json'.\" |\r\n| | 429 | `request_limit_reached` | \"The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.\" |\r\n| Server Error | 500 | `technical_issues` | \"We are currently facing some technical issues, please try again later.\" |\r\n| | | `unexpected_server_error` | \"An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.\" |\r\n| | 501 | `unimplemented` | \"This {feature} has not been implemented yet.\" |\r\n| | 503 | `temporary_shutdown_endpoint` | \"This endpoint is temporarily stopped due to performance reasons. For more information please contact our team via email.\" |\r\n\r\n\r\n### Custom errors:\r\n\r\n| Type of code | HTTP Status Code | Error code | Message |\r\n| :---: | :---: | :---: | :---: |\r\n| Client Error | 400 | `invalid_blockchain` | \"The provided blockchain is invalid. The blockchain **must** be a supported one. For the full list of supported blockchains please see our Documentation.\" |\r\n| | | `invalid_network` | \"The provided network is invalid. The network **must** be a supported one. For the full list of supported networks please see our Documentation.\" |\r\n| | | `waas_contact_group_is_missing` | \"Contact group was not found.\" |\r\n| | 403 | `wallet_as_a_service_contacts_limit_reached` | \"You have reached the maximum Contacts count which is currently {waasConstraintsCount}. 'Please, upgrade your plan in order to have a higher Contacts count.\" |\r\n| | | `wallet_as_a_service_deposit_addresses_limit_reached` | \"You have reached the maximum Deposit Addresses count which is currently {depositAddressesCount}. Please, upgrade your plan in order to have a higher Deposit Address count.\" |\r\n| | | `wallet_as_a_service_wallets_limit_reached` | You have reached the maximum Wallets count which is currently {walletsCount}. Please, upgrade your plan in order to have a higher Wallet count. |\r\n| | | `wallet_as_a_service_wallet_recovery_data_already_backed_up` | \"Your Wallet has been already backed up and that action cannot be done again. For further assistance please contact our team.\" |\r\n| | | `action_requests_user_cannot_approve_request` | \"User with ID: {userId} cannot approve this action request.\" |\r\n| | | `action_requests_request_already_approved_by_this_user` | \"User with ID: {userId} has already approved this action request.\" |\r\n| | | `action_requests_user_cannot_reject_request` | \"User with ID: {userId} cannot reject this action request.\" |\r\n| | 409 | `wallet_as_a_service_token_not_supported` | \"The token is not supported for this blockchain and network. To be supported, please contact our team.\" |\r\n| | | `wallet_as_a_service_no_deposit_addresses_found` | \"Please first create a deposit address for the specific blockchain and network, in order to be able to make transactions.\" |\r\n| | | `wallet_as_a_service_tokens_not_supported` | \"Tokens are not supported for the blockchain specified.\" |\r\n| | | `wallet_as_a_service_address_balance_not_enough` | \"Your address balance is insufficient to complete the action. Please, deposit funds to your address and try again.\" |\r\n| | | `wallet_as_a_service_wallet_balance_not_enough` | \"Your Wallet balance is insufficient to complete the action. Please, deposit funds to your Wallet and try again.\" |\r\n\r\n## Date and Time Formats\r\n\r\nFor all required endpoints that use a time parameter, the accepted value is `timestamp` which is always UTC-based by definition. The human date which corresponds to the `timestamp` is always converted by the system to UNIX Epoch time and returned as an integer.\r\n\r\n_**Example:**_\r\n\r\nHuman time: 09:12:41 AM 28th January 2021\r\n\r\nWhich corresponds to:\r\n\r\nUNIX Epoch time: 1611825161\r\n\r\nHence the system will return `\u201dtimestamp\u201d: 1611825161` and not the human time.\r\n\r\nThe UNIX Epoch time is a system that describes a point in time. This would be the amount of time in seconds that have passed since the Unix Epoch which was 00:00:00 UTC on 1 January 1970, minus leap seconds." }, { "name": "Generating", "description": "This category displays Wallet-as-a-Service endpoints which can be used to generate addresses for a Wallet." }, { "name": "Transactions", "description": "This category displays Wallet-as-a-Service endpoints which can be used to create transactions." }, { "name": "Informative", "description": "This category displays Wallet-as-a-Service endpoints which can be used to obtain information for the Wallet such as list deposit addresses." }, { "name": "Utils", "description": "This category displays Wallet-as-a-Service endpoints with useful features and tools for blockchain and crypto operations." }, { "name": "Webhooks", "description": "## Callbacks and Main Terminology\r\n\r\nLet's first define some main vocabulary related to callbacks that will make the process easier to talk about.\r\n\r\n\r\n### Callback\r\n\r\nShortly put, a \u201ccallback\u201d is a POST request sent from Vaultody to a customer\u2019s Callback URL when an event they have already subscribed for occurs.\r\n\r\nNow with a bit more detail, a \u201ccallback\u201d is used to describe an event reaction process where a user receives notifications on certain events after having first subscribed to them in the system. The term has become interchangeable with the word \u201cwebhook\u201d which is used to describe the same thing. Callbacks can be very useful for customers who want to be notified about the state of transactions on the blockchain.\r\n\r\nThere are two sides to the callback - the server side and the customer side. The process involves customers subscribing to events on the server side. Once an event is completed, the server side notifies the customer side about it.\r\n\r\n\r\n\r\n### Callback \r\n#### Definition\r\n\r\n\r\nSpecific processes are considered \"events\u201d. Simply put, an \u201cevent\u201d is something that occurs on the Blockchain. Vaultody incorporates various endpoints, which hold different characteristics. You can see endpoints that represent events to which users can subscribe for a callback on our Dashboard.\r\n\r\n\r\nSpecific processes are considered \"events\u201d. Simply put, an \u201cevent\u201d is something that occurs on the Blockchain. Vaultody incorporates various endpoints, which hold different characteristics.\r\n\r\n#### Types\r\n\r\nDifferent callback types exist, with a focus on the following:\r\n\r\nTransaction request-\r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"d270e680e511c191f8002820ecd0c7fbf64c2f5f4db14e57a1257571c48c4cb9\",\r\n \"data\": {\r\n \"event\": \"TRANSACTION_REQUEST\",\r\n \"item\": {\r\n \"blockchain\": \"tron\",\r\n \"network\": \"nile\",\r\n \"requestId\": \"64ddcc91225244d7f74a22a0\"\r\n }\r\n }\r\n}\r\n```\r\n\r\nTransaction approved -\r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"1bd6102fa987fe61bb7b826dc50d76b1d2259b28b726c61b133f4adb13a67eab\",\r\n \"data\": {\r\n \"event\": \"TRANSACTION_APPROVED\",\r\n \"item\": {\r\n \"blockchain\": \"tron\",\r\n \"currentApprovals\": 1,\r\n \"currentRejections\": 0,\r\n \"network\": \"nile\",\r\n \"requestId\": \"64ddcc91225244d7f74a22a0\",\r\n \"requiredApprovals\": 1,\r\n \"requiredRejections\": 1\r\n }\r\n }\r\n}\r\n```\r\n\r\nTransaction rejected -\r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"0f2328d33abe291efac1d5d1b19f8e2305fc695bd4b5ba462d68aec2417211eb\",\r\n \"data\": {\r\n \"event\": \"TRANSACTION_REJECTED\",\r\n \"item\": {\r\n \"blockchain\": \"tron\",\r\n \"currentApprovals\": 0,\r\n \"currentRejections\": 1,\r\n \"network\": \"nile\",\r\n \"requestId\": \"64de1681225244d7f797ae38\",\r\n \"requiredApprovals\": 1,\r\n \"requiredRejections\": 1\r\n }\r\n }\r\n}\r\n```\r\n\r\n\r\n\r\nIncoming confirmed coin transaction -\r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"ac167553f357b7bb389586003b130ffdcd9a01f318e9b89e085480f1c543de79\",\r\n \"data\": {\r\n \"event\": \"INCOMING_CONFIRMED_COIN_TX\",\r\n \"item\": {\r\n \"address\": \"TYtJcKwMerVDAWkRFXc1cQU5GjrPzsBk2y\",\r\n \"amount\": \"10\",\r\n \"blockchain\": \"tron\",\r\n \"currentConfirmations\": 1,\r\n \"direction\": \"incoming\",\r\n \"minedInBlock\": {\r\n \"hash\": \"000000000258de1b4b9128df238f7049cc8cb266f6b0d1c3674050e4b1e5f77e\",\r\n \"height\": 39378459,\r\n \"timestamp\": 1692259449\r\n },\r\n \"network\": \"nile\",\r\n \"targetConfirmations\": 12,\r\n \"transactionId\": \"a08f6dd8a8751a1de6de15f7978003b0ceda5e8c77ee4035c9550ef362ca7e55\",\r\n \"unit\": \"TRX\"\r\n }\r\n }\r\n}\r\n```\r\n\r\nIncoming confirmed token transaction -\r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"5cf55b85c652b1cf0e747da6b8b50d8785165eaf39d824048e166b33071e44e0\",\r\n \"data\": {\r\n \"event\": \"INCOMING_CONFIRMED_TOKEN_TX\",\r\n \"item\": {\r\n \"address\": \"TYtJcKwMerVDAWkRFXc1cQU5GjrPzsBk2y\",\r\n \"blockchain\": \"tron\",\r\n \"currentConfirmations\": 1,\r\n \"direction\": \"incoming\",\r\n \"minedInBlock\": {\r\n \"hash\": \"000000000258dc72b95dde4ec1f9ed9a32f3b1ebb558d89e6d9bbf0c5e577525\",\r\n \"height\": 39378034,\r\n \"timestamp\": 1692257442\r\n },\r\n \"network\": \"nile\",\r\n \"targetConfirmations\": 12,\r\n \"token\": {\r\n \"amount\": \"100\",\r\n \"contractAddress\": \"TXLAQ63Xg1NAzckPwKHvzw7CSEmLMEqcdj\",\r\n \"name\": \"Tether USD\",\r\n \"symbol\": \"USDT\"\r\n },\r\n \"tokenType\": \"TRC-20\"\r\n }\r\n }\r\n}\r\n```\r\n\r\nIncoming confirmed internal transaction -{\r\n```\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64d4d8133c61607960b5e023\",\r\n \"idempotencyKey\": \"f49af914f104185943859ba0ae0ff0a287e1ea09d8b0cce7296eada96f947aad\",\r\n \"data\": {\r\n \"event\": \"INCOMING_CONFIRMED_INTERNAL_TX\",\r\n \"item\": {\r\n \"address\": \"0xe2825763a2cd0057421a7e259d788c0fdf52ca7f\",\r\n \"amount\": \"0.0001\",\r\n \"blockchain\": \"ethereum\",\r\n \"currentConfirmations\": 11,\r\n \"direction\": \"incoming\",\r\n \"minedInBlock\": {\r\n \"hash\": \"0x44b172d382ac66285681e72c87ad16a7fa6a8c606d15a2f39fc6532d4f2721b5\",\r\n \"height\": 9498383,\r\n \"timestamp\": 1691736444\r\n },\r\n \"network\": \"goerli\",\r\n \"operationId\": \"call_0\",\r\n \"parentTransactionId\": \"0x271145589f36cbf274f687c2f0b62a5818f8bac9ddc3e4ae3425fb44cfc71774\",\r\n \"targetConfirmations\": 12,\r\n \"unit\": \"ETH\"\r\n }\r\n }\r\n}\r\n```\r\n\r\nIncoming Mined transaction -\r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"d76c3e57b96713046b6b31445781f4a80934660a33aeaca3a64ada46c9274f4e\",\r\n \"data\": {\r\n \"event\": \"INCOMING_MINED_TX\",\r\n \"item\": {\r\n \"address\": \"TYtJcKwMerVDAWkRFXc1cQU5GjrPzsBk2y\",\r\n \"blockchain\": \"tron\",\r\n \"currentConfirmations\": 12,\r\n \"direction\": \"incoming\",\r\n \"minedInBlock\": {\r\n \"hash\": \"000000000258dc72b95dde4ec1f9ed9a32f3b1ebb558d89e6d9bbf0c5e577525\",\r\n \"height\": 39378034,\r\n \"timestamp\": 1692257442\r\n },\r\n \"network\": \"nile\",\r\n \"targetConfirmations\": 12,\r\n \"token\": {\r\n \"amount\": \"100\",\r\n \"contractAddress\": \"TXLAQ63Xg1NAzckPwKHvzw7CSEmLMEqcdj\",\r\n \"name\": \"Tether USD\",\r\n \"symbol\": \"USDT\"\r\n },\r\n \"tokenType\": \"TRC-20\"\r\n }\r\n }\r\n}\r\n```\r\n\r\nOutgoing transaction failed - \r\n\r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64dcca5c3c61607960b5e02d\",\r\n \"idempotencyKey\": \"e14ab5620c3559334888f122eeef082dc999743f4e0373fedc29a0e2c3383d27\",\r\n \"data\": {\r\n \"event\": \"OUTGOING_FAILED\",\r\n \"item\": {\r\n \"blockchain\": \"xrp\",\r\n \"currentApprovals\": 1,\r\n \"currentRejections\": 0,\r\n \"failedReason\": \"TO_ADDRESS_MUST_BE_DIFFERENT_FROM_SOURCE_ADDRESS\",\r\n \"network\": \"testnet\",\r\n \"requestId\": \"64dccace225244d7f76c2b96\",\r\n \"requiredApprovals\": 1,\r\n \"requiredRejections\": 1\r\n }\r\n }\r\n}\r\n```\r\n\r\n\r\nOutgoing transaction mined - \r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"d8968a809bb0db2bc9769b603f040e2feca5afc1ef4c997d074e63b9a9c84228\",\r\n \"data\": {\r\n \"event\": \"OUTGOING_MINED\",\r\n \"item\": {\r\n \"blockchain\": \"tron\",\r\n \"currentApprovals\": 1,\r\n \"currentRejections\": 0,\r\n \"network\": \"nile\",\r\n \"requestId\": \"64ddcc91225244d7f74a22a0\",\r\n \"requiredApprovals\": 1,\r\n \"requiredRejections\": 1,\r\n \"transactionId\": \"df650eedd762d7027f37d9dfd2e0778e2356f140408188cd4303ac5a8a2efecd\"\r\n }\r\n }\r\n}\r\n```\r\n\r\nOutgoing transaction broadcasted - \r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"eda54869d487ae22ea0f7fcae1e389451ed4dd23251c7c1d7a9508e79bbe1878\",\r\n \"data\": {\r\n \"event\": \"TRANSACTION_BROADCASTED\",\r\n \"item\": {\r\n \"blockchain\": \"tron\",\r\n \"currentApprovals\": 1,\r\n \"currentRejections\": 0,\r\n \"network\": \"nile\",\r\n \"requestId\": \"64ddcc91225244d7f74a22a0\",\r\n \"requiredApprovals\": 1,\r\n \"requiredRejections\": 1,\r\n \"transactionId\": \"df650eedd762d7027f37d9dfd2e0778e2356f140408188cd4303ac5a8a2efecd\"\r\n }\r\n }\r\n}\r\n```\r\n\r\n\r\n### Callback URL\r\n\r\nCallbacks require what is known as a **\u201dCallback URL\u201d**. It is the destination where Vaultody sends the callback notification. Setting up this URL is done entirely on the customer\u2019s side and is the first step to setting up a Callback. \r\n\r\n\r\n## Vaultody Callback basics\r\n\r\nVaultody Callbacks follow certain basics and the same standard that applies to all callback subscriptions.\r\n\r\n- Callback requests sent from Vaultody are **always** POST;\r\n- All Vaultody headers must by default incorporate the JSON content type **application/json**;\r\n- All Vaultody Callbacks incorporate the use of a Callback URL, without exception.\r\n- The attribute `x-signature` is a custom for Vaultody parameter, as indicated with the `x-` in the beginning;\r\n- The structure of the Callback is always the same, no matter the subscription or type of event.\r\n\r\n\r\n## Callback standard structure\r\n\r\nThe callback structure has the following constant parameters:\r\n\r\n```\r\n{\r\n \"apiVersion\": \"2023-04-20\",\r\n \"webhookId\": \"64ddcbdceefc57211c59d736\",\r\n \"idempotencyKey\": \"8aa227b6638ee04764e6cda8bbed89a0a8df95532364e292d84051bccad4e78c\",\r\n \"data\": {\r\n \"event\": \"INCOMING_MINED_TX\",\r\n \"item\": {\r\n \"address\": \"TYtJcKwMerVDAWkRFXc1cQU5GjrPzsBk2y\",\r\n \"amount\": \"10\",\r\n \"blockchain\": \"tron\",\r\n \"currentConfirmations\": 12,\r\n \"direction\": \"incoming\",\r\n \"minedInBlock\": {\r\n \"hash\": \"000000000258de1b4b9128df238f7049cc8cb266f6b0d1c3674050e4b1e5f77e\",\r\n \"height\": 39378459,\r\n \"timestamp\": 1692259449\r\n },\r\n \"network\": \"nile\",\r\n \"targetConfirmations\": 12,\r\n \"transactionId\": \"a08f6dd8a8751a1de6de15f7978003b0ceda5e8c77ee4035c9550ef362ca7e55\",\r\n \"unit\": \"TRX\"\r\n }\r\n }\r\n}\r\n```\r\n\r\n\r\n### Idempotency and `idempotentKey`\r\n\r\nIdempotency represents a process in computing and REST that a server uses to recognize subsequent retries of the same request where the returned result always remains the same. It is a security mechanism for retrying requests without the risk of performing the same operation more than once.\r\n\r\nSuch risks usually occur when an API call is for some reason disrupted during processing (e.g. network connection error) and a response is not returned. In such cases, the API call would be retried. By including an **`idempotencyKey`** in the initial request, there is a guarantee that the specific action won\u2019t be done more than once.\r\n\r\nThe `idempotencyKey` is generated only on the server-end through the use of Vaultody Callbacks. It is added to the Callback request and is unique per initial callback request. `idempotencyKey` values are generated randomly. \r\n\r\nAll original requests containing an `idempotencyKey`, along with their body and response status code (both success and error), are saved by the system. After that, any subsequent requests containing the same `idempotencyKey` will automatically return the same result. \r\n\r\n\r\n## Setting up callbacks\r\n\r\nCallbacks combine certain elements and steps needed to create a correct reaction and on-time notification.\r\n\r\nTheir way of working requires the customer to first set up their Vault, and later on, whenever the subscription event occurs, the Vaultody will notify the customer. All steps are taken through the Vaultody Dashboard \r\n\r\n1. **Customer sets up Callback** \r\n\r\nIn the developers tab of the dashboard, you will see a Webhooks menu where you can add certain endpoints for which you would like to be notified. \r\n\r\n2. **Customer subscribes for an event**\r\n\r\nOnce you open the Add Endpoints module, you should select 4 main components. \r\nEndpoint URL where all notifications will be forwarded. \r\nSigned Secret key\r\nSelected Wallets that you would like to monitor.\r\nSelect the events for which you want to be notified. \r\n\r\n3. **Vaultody sends the Callback as a request**\r\n\r\nVaultody's responsibility to the customer is to notify them according to their subscription for that particular event or events **only when it/they occur**. Whenever the event happens, Vaultody sends a request back to the customer that includes the data on the event, as requested by the customer. This is essentially the \u201ccallback\u201d itself. If the callback is not confirmed by the customer side with a \u201c200 OK\u201d response, the system will follow a specific retry strategy.\r\n\r\nIt is also important to clarify that subscribing to an event and setting a callback for it **does not** necessarily mean that the callback will occur soon or even at all. We do everything possible to make sure that callbacks have no delays, errors, or issues, and are received as events occur. \r\n\r\nStill, not receiving a callback for a subscribed event for a long time could be due to many reasons. There may be events that need to take days, weeks, or months to occur even just once, and some that may encounter problems, errors, and never happen at all.\r\n\r\n### Callback Retries\r\n\r\nWhen the callback request is sent from Vaultody, it expects a response from the customer side as well. \r\n\r\nUntil a status code of \u201c200 OK Request has been successful\u201d is received, Vaultody will keep retrying the request. There will be three retries in total, distributed at certain intervals.\r\n\r\n - Vaultody will send the requested callback when it\u2019s time and a customer response is expected in the first 5 seconds;\r\n- If a response isn\u2019t received during that time frame the system is prepared to send **in total 3** retries of the callback;\r\n- The first callback retry will be sent after 30 minutes.\r\n- After that, each following callback will take twice as long to be sent compared to the previous one. This is done with the purpose of extending the time during which the customer is going to receive the notification and its retries and providing an opportunity for the customer to send a \u201c200 OK\u201d response;\r\n- Additionally, there\u2019s an included **\u201crandom value\u201d** into the algorithm as a factor of **\u201d0.2\u201d**, which creates small but important fluctuations in the time frames between callback retries. This ensures that when large volumes of callbacks are sent, they are not sent in bulk due to having the same time frames, which could otherwise lead to crashes and server issues.\r\n\r\n{note}Time frames in the system are measured in seconds, e.g. first callback retry will be send after 30 min = 1800 sec.{/note}\r\n\r\n\r\n## Callback Security\r\n\r\nVaultody has incorporated a security layer to keep callbacks from being intercepted, duplicated and to make sure customers are receiving their callbacks only from Vaultody.\r\n\r\n\r\n### Customer\u2019s Signing Secret\r\n\r\nThe customer\u2019s request can include data on the event they want to subscribe for and has the option to also have a `Signing Secret`. This parameter is a required security measure for the benefit of the customer. The `Signing Secret` can only be generated by the customer. It is used to create a unique hash string in the `x-signature` response header in the callback request sent from Vaultody when the event occurs.\r\n\r\nThe `Signing Secret`, and thus the `x-signature`, are set up per event subscription, not per single callback. Hence, the customer only needs to set up the `Signing Secret` once when creating the event. They can use a single `Signing Secret` for all subscriptions, or different ones for each subscription. The security is effective enough even with just one common `Signing Secret`.\r\n\r\n\r\n### Callback Signature\r\n\r\nThe `x-signature` is provided in the header of the callback and represents a unique hash derived from all the information included in the callback about the event (which must be JSON encoded) and the customer\u2019s `Signing Secret`.\r\n\r\nFor this purpose, HMAC_SHA256 is used. It stands for Hash-based message authentication code, and along with its cryptographic hash function SHA256, it represents higher security than any other authentication code.\r\n\r\nThe cryptographic strength of the HMAC depends upon the size of the `Signing Secret` that has been used. The most common attack against HMACs is brute force to uncover the secret key. HMACs are substantially less affected by collisions than their underlying hashing algorithms alone.\r\n\r\nWhen the customer receives the callback request from Vaultody, they can first check the `x-signature` before processing the request. By using their `Signing Secret`, which only they would know, together with the information from the callback, they can generate a hash and compare it to the `x-signature` hash that the Vaultody server has returned. They **must** match, which only then would authenticate Vaultody as the true sender. \r\n\r\nAfter authentication of the callback, the customer can then proceed to processing it. If the authentication with the `x-signature` fails, then the customer **must** ignore it as someone else is sending it." } ], "paths": { "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}/addresses": { "post": { "tags": [ "Generating" ], "operationId": "Generate Deposit Address", "summary": "Generate Deposit Address", "description": "Through this endpoint customers can generate a new Receiving/Deposit Addresses into their Wallet.", "x-cost": 500, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin", "enum": [ "bitcoin", "bitcoin-cash", "litecoin", "dogecoin", "dash", "ethereum", "ethereum-classic", "xrp", "zcash", "binance-smart-chain", "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet", "enum": [ "mainnet", "testnet", "mordor", "nile", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Represents the unique ID of the specific Wallet.", "example": "60c9d9921c38030006675ff6" }, "description": "Represents the unique ID of the specific Wallet.", "example": "60c9d9921c38030006675ff6" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateDepositAddressRB" } } } }, "responses": { "201": { "description": "The resource has been successfully created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateDepositAddressR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GenerateDepositAddressE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GenerateDepositAddressE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GenerateDepositAddressE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "404": { "description": "The specified resource has not been found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ResourceNotFound" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } }, "get": { "tags": [ "Informative" ], "operationId": "List Deposit Addresses", "summary": "List Deposit Addresses", "description": "Through this endpoint customers can pull a list of Deposit/Receiving Addresses they have already generated.\r\n\r\n{note}Please note that listing data from the same type will apply pagination on the results.{/note}", "x-cost": 100, "x-charge-count": 1, "x-is-list": true, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin", "enum": [ "bitcoin", "bitcoin-cash", "litecoin", "dogecoin", "dash", "ethereum", "ethereum-classic", "xrp", "zcash", "binance-smart-chain", "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet", "enum": [ "mainnet", "testnet", "mordor", "nile", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Represents the unique ID of the specific Wallet.", "example": "60c9d9921c38030006675ff6" }, "description": "Represents the unique ID of the specific Wallet.", "example": "60c9d9921c38030006675ff6" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "format": "int64", "description": "Defines how many items should be returned in the response per page basis.", "example": 50, "default": 50 }, "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, { "in": "query", "name": "offset", "required": false, "schema": { "type": "integer", "format": "int64", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0, "default": 0 }, "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListDepositAddressesR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListDepositAddressesE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListDepositAddressesE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListDepositAddressesE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "404": { "description": "The specified resource has not been found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ResourceNotFound" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}/transaction-requests": { "post": { "tags": [ "Transactions" ], "operationId": "Create Coins Transaction Request from Vault", "summary": "Create Coins Transaction Request from Vault", "description": "Through this endpoint users can create a new transaction request from the entire Wallet instead from just a specific address. This endpoint can generate transactions from multiple to multiple addresses.\r\n\r\n{warning}This is available **only** for UTXO-based protocols such as Bitcoin, Bitcoin Cash, Litecoin, etc. It **is not** available for Account-based protocols like Ethereum.{/warning}", "x-cost": 500, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin", "enum": [ "bitcoin", "bitcoin-cash", "litecoin", "dogecoin", "dash", "zcash" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet", "default": "testnet", "enum": [ "mainnet", "testnet" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Represents the sender's specific and unique Wallet ID of the sender.", "example": "609e221675d04500068718dc" }, "description": "Represents the sender's specific and unique Wallet ID of the sender.", "example": "609e221675d04500068718dc" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromVaultRB" } } } }, "responses": { "201": { "description": "The resource has been successfully created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromVaultR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromVaultE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromVaultE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromVaultE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "409", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromVaultE409" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}/addresses/{address}/transaction-requests": { "post": { "tags": [ "Transactions" ], "operationId": "Create Coins Transaction Request from Address", "summary": "Create Coins Transaction Request from Address", "description": "Through this endpoint users can create a new single transaction request from one address to another.", "x-cost": 500, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "type": "string", "description": "Defines the specific source address for the transaction. For XRP we also support the X-address format.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" }, "description": "Defines the specific source address for the transaction. For XRP we also support the X-address format.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" }, { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum", "enum": [ "ethereum", "ethereum-classic", "binance-smart-chain", "xrp" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli", "enum": [ "mainnet", "mordor", "testnet", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Represents the sender's specific and unique Wallet ID of the sender.", "example": "629df9dbae857c00073de9c8" }, "description": "Represents the sender's specific and unique Wallet ID of the sender.", "example": "629df9dbae857c00073de9c8" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromAddressRB" } } } }, "responses": { "201": { "description": "The resource has been successfully created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromAddressR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromAddressE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromAddressE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromAddressE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "409", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionRequestFromAddressE409" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}/addresses/{address}/all-transaction-requests": { "post": { "tags": [ "Transactions" ], "operationId": "Create Coins Transaction From Address For Whole Amount", "summary": "Create Coins Transaction From Address For Whole Amount", "description": "Through this endpoint customers can create a new transaction from address for **coins** specifically, which will transfer over the entire available amount.", "x-cost": 500, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "type": "string", "description": "Defines the source address.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" }, "description": "Defines the source address.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" }, { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum", "enum": [ "ethereum", "ethereum-classic", "binance-smart-chain", "xrp" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli", "enum": [ "mainnet", "mordor", "testnet", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Represents the sender's specific and unique Wallet ID of the sender.", "example": "629df9dbae857c00073de9c8" }, "description": "Represents the sender's specific and unique Wallet ID of the sender.", "example": "629df9dbae857c00073de9c8" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCoinsTransactionFromAddressForWholeAmountRB" } } } }, "responses": { "201": { "description": "The resource has been successfully created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCoinsTransactionFromAddressForWholeAmountR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionFromAddressForWholeAmountE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionFromAddressForWholeAmountE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionFromAddressForWholeAmountE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "409", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateCoinsTransactionFromAddressForWholeAmountE409" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}": { "get": { "tags": [ "Informative" ], "operationId": "Get Vault Asset Details", "summary": "Get Vault Asset Details", "description": "Through this endpoint customers can obtain details on all assets (coins, fungible tokens, non-fungible tokens) for the entire Wallet.", "x-cost": 100, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin", "enum": [ "bitcoin", "bitcoin-cash", "litecoin", "dogecoin", "dash", "ethereum", "ethereum-classic", "xrp", "zcash", "binance-smart-chain", "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet", "enum": [ "mainnet", "testnet", "mordor", "nile", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Defines the unique ID of the Wallet.", "example": "60c9d9921c38030006675ff6" }, "description": "Defines the unique ID of the Wallet.", "example": "60c9d9921c38030006675ff6" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetVaultAssetDetailsR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetVaultAssetDetailsE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetVaultAssetDetailsE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetVaultAssetDetailsE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "404": { "description": "The specified resource has not been found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ResourceNotFound" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}/addresses/{senderAddress}/token-transaction-requests": { "post": { "tags": [ "Transactions" ], "operationId": "Create Fungible Tokens Transaction Request From Address", "summary": "Create Fungible Tokens Transaction Request From Address", "description": "Through this endpoint users can make a single token transaction.\r\n\r\n{note}To have an operational callback subscription, you need to first verify a domain for the Callback URL. Please see more information on Callbacks [here](https://developers.vaultody.com/technical-documentation/general-information/callbacks#callback-url).{/note}\r\n\r\n{warning}Vaultody will notify the user **only when** the event occurs. There are cases when the specific event doesn't happen at all, or takes a long time to do so. A callback notification **will not** be sent if the event does not or cannot occur, or will take long time to occur.{/warning}", "x-cost": 500, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum", "enum": [ "ethereum", "ethereum-classic", "binance-smart-chain" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli", "enum": [ "mainnet", "mordor", "testnet", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli" }, { "in": "path", "name": "senderAddress", "required": true, "schema": { "type": "string", "description": "Defines the specific source address for the transaction.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" }, "description": "Defines the specific source address for the transaction.", "example": "0x0902a667d6a3f287835e0a4593cae4167384abc6" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Defines the unique ID of the Wallet.", "example": "609e221675d04500068718dc" }, "description": "Defines the unique ID of the Wallet.", "example": "609e221675d04500068718dc" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressRB" } } } }, "responses": { "201": { "description": "The resource has been successfully created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "409", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateFungibleTokensTransactionRequestFromAddressE409" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/all-assets": { "get": { "tags": [ "Informative" ], "operationId": "List All Assets From All Vaults", "summary": "List All Assets From All Vaults", "description": "Through this endpoint customers can obtain information about available assets in all of their wallets, regardless of the blockchain protocol or network.", "x-cost": 500, "x-charge-count": 1, "x-is-list": true, "parameters": [ { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "format": "int64", "description": "Defines how many items should be returned in the response per page basis.", "example": 50, "default": 50 }, "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, { "in": "query", "name": "offset", "required": false, "schema": { "type": "integer", "format": "int64", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0, "default": 0 }, "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListAllAssetsFromAllVaultsR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListAllAssetsFromAllVaultsE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListAllAssetsFromAllVaultsE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListAllAssetsFromAllVaultsE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/assets": { "get": { "tags": [ "Informative" ], "operationId": "List All Assets By Vault ID", "summary": "List All Assets By Vault ID", "description": "Through this endpoint customers can obtain information about available assets in one of their wallets, regardless of the blockchain protocol or network, by providing walletId.", "x-cost": 500, "x-charge-count": 1, "x-is-list": true, "parameters": [ { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Defines the unique ID of the Wallet.", "example": "60c9d9921c38030006675ff6" }, "description": "Defines the unique ID of the Wallet.", "example": "60c9d9921c38030006675ff6" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListAllAssetsByVaultIDR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListAllAssetsByVaultIDE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListAllAssetsByVaultIDE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListAllAssetsByVaultIDE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "404": { "description": "The specified resource has not been found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ResourceNotFound" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/transactionRequests/{transactionRequestId}": { "get": { "tags": [ "Informative" ], "operationId": "Get Transaction Request Details", "summary": "Get Transaction Request Details", "description": "Through this endpoint customers can obtain details on transaction request.\r\n\r\n{note}This regards **transaction requests**, which is not to be confused with **transactions**. Transaction requests may not be approved due to any reason, hence a transaction may not occur.{/note}", "x-cost": 500, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "transactionRequestId", "required": true, "schema": { "type": "string", "description": "Represents the unique ID of the transaction request.", "example": "6115126693397c0006f78eb4" }, "description": "Represents the unique ID of the transaction request.", "example": "6115126693397c0006f78eb4" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTransactionRequestDetailsR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetTransactionRequestDetailsE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetTransactionRequestDetailsE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetTransactionRequestDetailsE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}/addresses/{address}/feeless-transaction-requests": { "post": { "tags": [ "Transactions" ], "operationId": "Create Single Transaction Request From Address Without Fee Priority", "summary": "Create Single Transaction Request From Address Without Fee Priority", "description": "Through this endpoint users can create a new single transaction request from one address to another. The difference between this endpoint and \"Create Coins Transaction Request from Address\" is that for Tron blockchain there is no Fee Priority that defines how fast a transaction can be mined.", "x-cost": 500, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "type": "string", "description": "Defines the specific source address for the transaction.", "example": "TX8VXpdEoNNrKeEuNTfbEXfa9eZivcyUwD" }, "description": "Defines the specific source address for the transaction.", "example": "TX8VXpdEoNNrKeEuNTfbEXfa9eZivcyUwD" }, { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "tron", "enum": [ "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "tron" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "nile", "enum": [ "mainnet", "nile" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "nile" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Represents the sender's specific and unique Wallet ID of the sender.", "example": "62b9b5c3b97f4b0008092714" }, "description": "Represents the sender's specific and unique Wallet ID of the sender.", "example": "62b9b5c3b97f4b0008092714" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSingleTransactionRequestFromAddressWithoutFeePriorityRB" } } } }, "responses": { "201": { "description": "The resource has been successfully created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSingleTransactionRequestFromAddressWithoutFeePriorityR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateSingleTransactionRequestFromAddressWithoutFeePriorityE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateSingleTransactionRequestFromAddressWithoutFeePriorityE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateSingleTransactionRequestFromAddressWithoutFeePriorityE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "409", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateSingleTransactionRequestFromAddressWithoutFeePriorityE409" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}/transactions": { "get": { "tags": [ "Informative" ], "operationId": "List Vault Transactions", "summary": "List Vault Transactions", "description": "Through this endpoint customers can list Transactions from and to their Wallet. The data returned will include `transactionId`, `direction` of the transaction - incoming or outgoing, `amount` and more.", "x-cost": 100, "x-charge-count": 1, "x-is-list": true, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum", "enum": [ "bitcoin", "bitcoin-cash", "litecoin", "dogecoin", "dash", "ethereum", "ethereum-classic", "xrp", "zcash", "binance-smart-chain", "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli", "enum": [ "mainnet", "testnet", "mordor", "nile", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Represents the unique ID of the specific Wallet.", "example": "629df9dbae857c00073de9c8" }, "description": "Represents the unique ID of the specific Wallet.", "example": "629df9dbae857c00073de9c8" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "format": "int64", "description": "Defines how many items should be returned in the response per page basis.", "example": 50, "default": 50 }, "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, { "in": "query", "name": "offset", "required": false, "schema": { "type": "integer", "format": "int64", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0, "default": 0 }, "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListVaultTransactionsR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListVaultTransactionsE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListVaultTransactionsE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListVaultTransactionsE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "404": { "description": "The specified resource has not been found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ResourceNotFound" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{walletId}/{blockchain}/{network}/addresses/{senderAddress}/feeless-token-transaction-requests": { "post": { "tags": [ "Transactions" ], "operationId": "Create Fungible Token Transaction Request From Address Without Fee Priority", "summary": "Create Fungible Token Transaction Request From Address Without Fee Priority", "description": "Through this endpoint customers can make a single feeless token transaction on the Tron blockchain protocol. TRX transactions burn certain resources called Bandwidth and Energy. Each account has 1500 bandwidth free for use every 24 hours and more can be obtained by staking TRX. The unit price of Energy is 280 SUN and of bandwidth - 1000 SUN. If the resources are insufficient, TRX will be burned to pay for them.", "x-cost": 500, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "tron", "enum": [ "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "tron" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "nile", "enum": [ "mainnet", "nile" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "nile" }, { "in": "path", "name": "senderAddress", "required": true, "schema": { "type": "string", "description": "Defines the specific source address for the transaction.", "example": "TX8VXpdEoNNrKeEuNTfbEXfa9eZivcyUwD" }, "description": "Defines the specific source address for the transaction.", "example": "TX8VXpdEoNNrKeEuNTfbEXfa9eZivcyUwD" }, { "in": "path", "name": "walletId", "required": true, "schema": { "type": "string", "description": "Defines the unique ID of the Wallet.", "example": "62b9b5c3b97f4b0008092714" }, "description": "Defines the unique ID of the Wallet.", "example": "62b9b5c3b97f4b0008092714" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityRB" } } } }, "responses": { "201": { "description": "The resource has been successfully created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "409", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/CreateFungibleTokenTransactionRequestFromAddressWithoutFeePriorityE409" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/wallets/{blockchain}/{network}/transactions/{transactionId}": { "get": { "tags": [ "Informative" ], "operationId": "Get Vault Transaction Details By Transaction ID", "summary": "Get Vault Transaction Details By Transaction ID", "description": "Through this endpoint users can obtain Wallet transaction information by providing a `transactionId`. Customers can receive information only for a transaction that has been made from their own wallet.", "x-cost": 100, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin", "enum": [ "bitcoin", "ethereum", "litecoin", "bitcoin-cash", "ethereum-classic", "dogecoin", "dash", "zcash", "binance-smart-chain", "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet", "enum": [ "mainnet", "testnet", "mordor", "nile", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet" }, { "in": "path", "name": "transactionId", "required": true, "schema": { "type": "string", "description": "Represents the unique identifier of a transaction, i.e. it could be `transactionId` in UTXO-based protocols like Bitcoin, and transaction `hash` in Ethereum blockchain.", "example": "3e081861494aed897e589cdeab5d9e628d985e571ed1c19896d1aa698cce9d80" }, "description": "Represents the unique identifier of a transaction, i.e. it could be `transactionId` in UTXO-based protocols like Bitcoin, and transaction `hash` in Ethereum blockchain.", "example": "3e081861494aed897e589cdeab5d9e628d985e571ed1c19896d1aa698cce9d80" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/GetVaultTransactionDetailsByTransactionIDE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "404": { "description": "The specified resource has not been found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ResourceNotFound" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/blockchain-tools/{blockchain}/{network}/addresses/validate": { "post": { "tags": [ "Utils" ], "operationId": "Validate Address", "summary": "Validate Address", "description": "This endpoint checks user public addresses whether they are valid or not.", "x-cost": 100, "x-charge-count": 1, "x-is-list": false, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin", "enum": [ "bitcoin", "bitcoin-cash", "litecoin", "dogecoin", "dash", "ethereum", "ethereum-classic", "zcash", "binance-smart-chain", "xrp", "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "bitcoin" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet", "enum": [ "mainnet", "testnet", "ropsten", "goerli", "mordor", "nile" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "testnet" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateAddressRB" } } } }, "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateAddressR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ValidateAddressE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ValidateAddressE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ValidateAddressE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/vaults": { "get": { "tags": [ "Informative" ], "operationId": "List Vaults", "summary": "List Vaults", "description": "This endpoint allows users to retrieve information about their vaults and provides details about each vault's ID, name, backup status, and type (whether it's a test or main vault).", "x-cost": 0, "x-charge-count": 1, "x-is-list": true, "parameters": [ { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "format": "int64", "description": "Defines how many items should be returned in the response per page basis.", "example": 50, "default": 50 }, "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, { "in": "query", "name": "offset", "required": false, "schema": { "type": "integer", "format": "int64", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0, "default": 0 }, "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListVaultsR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListVaultsE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListVaultsE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListVaultsE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } }, "/wallet-as-a-service/info/{blockchain}/{network}/supported-tokens": { "get": { "tags": [ "Informative" ], "operationId": "List Supported Tokens", "summary": "List Supported Tokens", "description": "Through this endpoint customers can obtain information on multiple tokens at once.", "x-cost": 100, "x-charge-count": 1, "x-is-list": true, "parameters": [ { "in": "path", "name": "blockchain", "required": true, "schema": { "type": "string", "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum", "enum": [ "ethereum", "ethereum-classic", "binance-smart-chain", "tron" ] }, "description": "Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.", "example": "ethereum" }, { "in": "path", "name": "network", "required": true, "schema": { "type": "string", "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli", "enum": [ "mainnet", "testnet", "mordor", "nile", "goerli" ] }, "description": "Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - \"mainnet\" is the live network with actual data while networks like \"testnet\", \"goerli\" are test networks.", "example": "goerli" }, { "in": "query", "name": "context", "required": false, "schema": { "type": "string", "example": "yourExampleString" }, "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "format": "int64", "description": "Defines how many items should be returned in the response per page basis.", "example": 50, "default": 50 }, "description": "Defines how many items should be returned in the response per page basis.", "example": 50 }, { "in": "query", "name": "offset", "required": false, "schema": { "type": "integer", "format": "int64", "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0, "default": 0 }, "description": "The starting index of the response items, i.e. where the response should start listing the returned items.", "example": 0 } ], "responses": { "200": { "description": "The request has been successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSupportedTokensR" } } } }, "400": { "description": "400", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListSupportedTokensE400" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "401": { "description": "401", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListSupportedTokensE401" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "402": { "description": "You have insufficient credits. Please upgrade your plan from your Dashboard or contact our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InsufficientCredits" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "403": { "description": "403", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/ListSupportedTokensE403" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "409": { "description": "The data provided seems to be invalid.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidData" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "415": { "description": "The selected Media Type is unavailable. The Content-Type header should be 'application/json'.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnsupportedMediaType" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "422": { "description": "Your request body for POST requests must have a structure of { data: { item: [...properties] } }", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/InvalidRequestBodyStructure" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "429": { "description": "The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/RequestLimitReached" } }, "required": [ "apiVersion", "requestId", "error" ] } } } }, "500": { "description": "An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email.", "content": { "application/json": { "schema": { "type": "object", "properties": { "apiVersion": { "type": "string", "description": "Specifies the version of the API that incorporates this endpoint.", "example": "2023-04-20" }, "requestId": { "type": "string", "description": "Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.", "example": "601c1710034ed6d407996b30" }, "context": { "type": "string", "description": "In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.", "example": "yourExampleString" }, "error": { "$ref": "#/components/schemas/UnexpectedServerError" } }, "required": [ "apiVersion", "requestId", "error" ] } } } } } } } }, "x-tagGroups": [ { "name": "General Information", "tags": [ "Getting Started", "Authentication", "Data Flow Limiting", "Standards Conventions and Versioning", "Webhooks" ] }, { "name": "Wallet as a Service", "tags": [ "Generating", "Transactions", "Informative", "Utils" ] } ] }