{ "info": { "_postman_id": "337d0a20-d4d6-495d-91f3-db670c446314", "name": "Custody Starter Architecture", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "39753201", "_collection_link": "https://go.postman.co/collection/39753201-337d0a20-d4d6-495d-91f3-db670c446314?source=collection_link" }, "item": [ { "name": "Set Up Custody Wallet", "item": [ { "name": "Create Custody Wallet", "item": [ { "name": "Add wallet", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"evmKeyRingReferenceWalletId\": 6729\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/add", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "add" ], "variable": [ { "key": "coin", "value": "btc" } ] }, "description": "Add Wallet is for advanced API users. It lets you manually create and\nspecify keys. The recommended (and simpler) method is [Generate Wallet](/reference/expresswalletgenerate)\nwith the SDK or BitGo Express. You can also create wallets in the BitGo UI.\n\nThis API creates a new wallet for the user or enterprise. The keys to\nuse with the new wallet (passed in the 'keys' parameter) must be\nregistered with BitGo prior to using this API.\n\nBitGo currently only supports 2-of-3 (e.g., m=2 and n=3) wallets. The\nthird key, and only the third key, must be a BitGo key. The first key\nis by convention the user key, with its encrypted xprv stored on BitGo.\n\nEthereum and XRP wallets can only be created under an enterprise. Pass in the\nid of the enterprise to associate the wallet with. Your enterprise id\ncan be seen by clicking on the \"Manage Organization\" link in the\nenterprise dropdown. Using the Add Wallet API, you can create a wallet\nusing either the enterprise fee address (used by default for all\nwallets in the enterprise), or a unique fee address (created manually\nwith the Keychains API). Pass the desired key as the third key ID in\nthe 'keys' array. In either case, the fee address must be funded\nbefore creating the wallet.\n\nYou cannot generate a wallet by passing in a subtoken (i.e. ERC20 token) as the coin.\nSubtokens use the wallet of their parent coin and it is not possible to create a\nwallet specific to one token. For example, to create a wallet for an ERC20 token,\ncreate an Ethereum wallet. It can hold any ERC20 tokens as well as Ether.\n\nBitGo Ethereum wallet is a smart-contract implementing multi-signature scheme.\nBecause contracts itself can not initiate transactions, fee addresses are used\nfor this purpose. Ethereum transactions initiated by a given address, are\nconfirmed by the network in order of creation, so one lower fee transaction can\npotentially delay all subsequent transactions. To help lower network fee costs,\ntwo fee addresses are provided.\n\n`feeAddress` is a main fee address usable for all operations.\n`lowPriorityFeeAddress` is a secondary fee address that can be used to pay\nlower fee for Create Address operations without risking delaying subsequent\nhigher-priority transactions initiated by main fee address.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"evmKeyRingReferenceWalletId\": 6729\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/add", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "add" ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"approvalsRequired\": 1,\n \"coin\": \"btc\",\n \"deleted\": false,\n \"disableTransactionNotifications\": true,\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"label\": \"My Wallet\",\n \"admin\": {\n \"policy\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"latest\": true,\n \"rules\": [\n {\n \"id\": \"string\",\n \"lockDate\": \"1991-10-19T22:58:08.721Z\",\n \"type\": \"coinAddressBlacklist\",\n \"action\": {\n \"type\": \"getApproval\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n },\n \"mutabilityConstraint\": \"permanent\",\n \"coin\": \"btc\",\n \"condition\": {\n \"amountString\": \"2000000\",\n \"timeWindow\": 1928182\n }\n },\n {\n \"id\": \"string\",\n \"lockDate\": \"1978-12-28T11:07:16.850Z\",\n \"type\": \"bitcoinAddressWhitelist\",\n \"action\": {\n \"type\": \"getFinalApproval\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n },\n \"mutabilityConstraint\": \"permanent\",\n \"coin\": \"btc\",\n \"condition\": {\n \"amountString\": \"2000000\",\n \"timeWindow\": 679706\n }\n }\n ],\n \"version\": 7071,\n \"date\": \"2008-09-07T18:16:35.693Z\",\n \"label\": \"string\"\n }\n },\n \"allowBackupKeySigning\": true,\n \"balanceString\": \"2000000\",\n \"buildDefaults\": {\n \"minFeeRate\": 12000,\n \"maxFeeRate\": 18000,\n \"feeMultiplier\": 1.2,\n \"changeAddressType\": \"p2wsh\",\n \"txFormat\": \"psbt\",\n \"autoReserveUnspentsOnBuildMins\": 60\n },\n \"coinSpecific\": {\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\",\n \"stellarUsername\": \"foo_bar@baz.com\",\n \"homeDomain\": \"bitgo.com\",\n \"stellarAddress\": \"foo_bar@baz.com*bitgo.com\"\n },\n \"custodialWallet\": {},\n \"custodialWalletId\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"freeze\": {\n \"time\": \"string\",\n \"expires\": \"string\",\n \"reason\": \"UserRequest\",\n \"referenceId\": \"string\",\n \"adminOrUserId\": \"string\"\n },\n \"isCold\": true,\n \"keys\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"m\": 2,\n \"n\": 3,\n \"nodeId\": \"59cd72485007a239fb00282ed480da1f\",\n \"receiveAddress\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 8974,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1991-08-16T08:38:11.934Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 6490,\n \"totalSent\": 8453,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n },\n \"recoverable\": true,\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"spendableBalanceString\": \"2000000\",\n \"unspentCount\": 100,\n \"startDate\": \"1978-03-14T00:17:30.213Z\",\n \"type\": \"custodialPaired\",\n \"users\": [\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"admin\",\n \"trade\"\n ]\n },\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"spend\",\n \"admin\"\n ]\n }\n ],\n \"customChangeKeySignatures\": {\n \"user\": \"string\",\n \"backup\": \"string\",\n \"bitgo\": \"string\"\n },\n \"multisigType\": \"tss\",\n \"multisigTypeVersion\": \"MPCv2\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"evmKeyRingReferenceWalletId\": 6729\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/add", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "add" ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Forbidden", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"evmKeyRingReferenceWalletId\": 6729\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/add", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "add" ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] } ] }, { "name": "Configure Recommended Policies", "item": [ { "name": "Create policy rule", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] }, "description": "Creates a new policy rule." }, "response": [ { "name": "The newly created policy rule", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"uniqueId\": \"c3ff569e-e30a-4405-8b76-38de240c724a\",\n \"id\": \"4fa8326b-4f5f-4065-8cfc-85a08c290c49\",\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"status\": \"ACTIVE\",\n \"version\": 1,\n \"adminOnly\": false,\n \"touchpointLabel\": \"Transfer from a Segregated Wallet\",\n \"scopeLabel\": \"Wallet\",\n \"clauses\": [\n {\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ],\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n },\n \"name\": \"wallet.ids\"\n }\n ],\n \"locked\": true,\n \"lockType\": \"PERMANENT\",\n \"enterpriseId\": \"5d1a5f2c8f0a9c001a5f2c8f0ad00000\",\n \"lastTriggeredDate\": \"2023-11-13T14:49:48.830522Z\",\n \"lastTriggeredEvaluationId\": \"306258df-dcab-489e-a9fe-ff28ce9fa312\",\n \"createdBy\": \"5d1a5f2c8f0a9c001a5f2c8f0ad00000\",\n \"modifiedBy\": \"5d1a5f2c8f0a9c001a5f2c8f0ad00000\",\n \"evaluationId\": \"306258df-dcab-489e-a9fe-ff28ce9fa312\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"BadRequest\",\n \"message\": \"Bad Request\",\n \"status\": 400\n}" }, { "name": "Unauthorized", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"Unauthorized\",\n \"message\": \"Unauthorized\",\n \"status\": 401\n}" }, { "name": "Forbidden", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"AccessDenied\",\n \"message\": \"License not added for enterprise\",\n \"status\": 403\n}" }, { "name": "The specified resource was not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"NotFound\",\n \"message\": \"Touchpoint not found\",\n \"status\": 404\n}" }, { "name": "Server Error - Transient error please try again", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"Internal_Server_Error\",\n \"message\": \"Database is down\",\n \"status\": 500\n}" } ] } ] }, { "name": "Withdrawal Flow", "item": [ { "name": "Multisignature", "item": [ { "name": "Initiate a transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 139,\n \"feeRate\": \"2000000\",\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 1150,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 4633,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 2804824334,\n \"maxFeePerGas\": 9165\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": 212,\n \"maxValue\": 6564,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 2672,\n \"ledgerSequenceDelta\": 4387,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 3171,\n \"validToBlock\": 9024,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"1984-03-28T23:12:34.405Z\"\n },\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": 2567,\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n }\n ],\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/initiate", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "initiate" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Initiate an unsigned transaction to create a pending approval. This is useful to request funds to be sent from custodial wallets. Use only with custodial wallets." }, "response": [ { "name": "Accepted", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 139,\n \"feeRate\": \"2000000\",\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 1150,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 4633,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 2804824334,\n \"maxFeePerGas\": 9165\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": 212,\n \"maxValue\": 6564,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 2672,\n \"ledgerSequenceDelta\": 4387,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 3171,\n \"validToBlock\": 9024,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"1984-03-28T23:12:34.405Z\"\n },\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": 2567,\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n }\n ],\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/initiate", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "initiate" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1989-05-31T09:35:58.829Z\",\n \"info\": {\n \"policyRuleRequest\": {\n \"action\": \"string\",\n \"updateEnterpriseRequest\": {\n \"type\": \"updateEnterpriseRequest\",\n \"action\": \"remove\",\n \"permission\": \"admin\",\n \"userId\": \"string\",\n \"email\": \"user@example.com\"\n }\n },\n \"type\": \"policyRuleRequest\"\n },\n \"state\": \"approved\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"pendingVideoApproval\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 139,\n \"feeRate\": \"2000000\",\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 1150,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 4633,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 2804824334,\n \"maxFeePerGas\": 9165\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": 212,\n \"maxValue\": 6564,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 2672,\n \"ledgerSequenceDelta\": 4387,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 3171,\n \"validToBlock\": 9024,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"1984-03-28T23:12:34.405Z\"\n },\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": 2567,\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n }\n ],\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/initiate", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "initiate" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Update pending approval", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Updates the state of a pending approval to `approved` or `rejected`.\nYou can manage pending approvals programmatically by API or with the\nBigGo web UI. Ensure your authentication token has the proper scope.\nWhen creating an access token in the web UI, check the permission,\n\"Update Pending Approvals\" (under \"Account Settings\" > \"Developer\nOptions\" > \"Access Tokens\").\n\nBitGo recommends that you create a webhook policy so that you can\nautomate approving and rejecting transactions.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Accepted", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" } ] } ] }, { "name": "MPC", "item": [ { "name": "Create transaction request", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Allows users to create a transaction request given they have spender permissions on the wallet. Use only with MPC wallets. For multisignature wallets, use [Build a transaction](/reference/v2wallettxbuild)." }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequestId\": \"string\",\n \"version\": 962.564638517922,\n \"latest\": false,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1958-06-05T10:04:39.057Z\",\n \"createdDate\": \"2024-05-29T09:49:46.292Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"intentType\": \"transferStake\",\n \"enableTokens\": [\n {\n \"name\": \"string\",\n \"address\": \"string\"\n }\n ],\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n }\n ],\n \"walletType\": \"advanced\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"selfSend\": true,\n \"intentType\": \"transferReject\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": 5570.607554665372\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"feeOptions\": {\n \"gasLimit\": 295.37930655326505,\n \"maxFeePerGas\": 2882.2355055659887,\n \"maxPriorityFeePerGas\": 8776.593048243323\n },\n \"hopParams\": {\n \"gasPriceMax\": 4342.861276232715,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 4877.688888752396\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": false,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 3677.794523097193,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": false,\n \"value\": 4657.505498904082,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": false,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 464.16276858725735,\n \"derivationIndex\": 7407.991523888358,\n \"address\": \"string\",\n \"chain\": 495.6934451736261,\n \"index\": 9603.794985209446\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n}" }, { "name": "Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequestId\": \"string\",\n \"version\": 962.564638517922,\n \"latest\": false,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1958-06-05T10:04:39.057Z\",\n \"createdDate\": \"2024-05-29T09:49:46.292Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"intentType\": \"transferStake\",\n \"enableTokens\": [\n {\n \"name\": \"string\",\n \"address\": \"string\"\n }\n ],\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n }\n ],\n \"walletType\": \"advanced\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"selfSend\": true,\n \"intentType\": \"transferReject\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": 5570.607554665372\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"feeOptions\": {\n \"gasLimit\": 295.37930655326505,\n \"maxFeePerGas\": 2882.2355055659887,\n \"maxPriorityFeePerGas\": 8776.593048243323\n },\n \"hopParams\": {\n \"gasPriceMax\": 4342.861276232715,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 4877.688888752396\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": false,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 3677.794523097193,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": false,\n \"value\": 4657.505498904082,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": false,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 464.16276858725735,\n \"derivationIndex\": 7407.991523888358,\n \"address\": \"string\",\n \"chain\": 495.6934451736261,\n \"index\": 9603.794985209446\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Unauthorized", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Forbidden", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Not Found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Update pending approval", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Updates the state of a pending approval to `approved` or `rejected`.\nYou can manage pending approvals programmatically by API or with the\nBigGo web UI. Ensure your authentication token has the proper scope.\nWhen creating an access token in the web UI, check the permission,\n\"Update Pending Approvals\" (under \"Account Settings\" > \"Developer\nOptions\" > \"Access Tokens\").\n\nBitGo recommends that you create a webhook policy so that you can\nautomate approving and rejecting transactions.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Accepted", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" } ] } ] } ] } ] }, { "name": "Set Up Standby Wallet", "item": [ { "name": "Create Standby Wallet", "item": [ { "name": "Multisignature", "item": [ { "name": "Generate wallet", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"label\": \"My Wallet\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"multisigType\": \"onchain\",\n \"type\": \"custodial\",\n \"passphrase\": \"string\",\n \"userKey\": \"string\",\n \"backupXpub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"backupXpubProvider\": \"dai\",\n \"disableTransactionNotifications\": true,\n \"passcodeEncryptionCode\": \"string\",\n \"coldDerivationSeed\": \"string\",\n \"gasPrice\": 1888,\n \"disableKRSEmail\": false,\n \"walletVersion\": 1,\n \"isDistributedCustody\": false,\n \"bitgoKeyId\": \"59cd72485007a239fb00282ed480da1f\",\n \"commonKeychain\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/generate?includeKeychains=false", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "generate" ], "query": [ { "key": "includeKeychains", "value": "false" } ], "variable": [ { "key": "coin", "value": "btc" } ] }, "description": "Generate a new wallet for a coin. If you want a wallet to hold tokens, generate a wallet for the native coin of the blockchain (e.g. generate an ETH wallet to hold ERC20 tokens).\n\nCalling this endpoint does all of the following:\n\n* Creates the user keychain locally on your machine and encrypts it with the provided passphrase (skipped if you pass a `userKey`).\n* Creates the backup keychain locally on your machine.\n* Uploads the encrypted user keychain and public backup keychain to BitGo.\n* Creates the BitGo key (and the backup key if you pass `backupXpubProvider`) on the service.\n* Creates the wallet on BitGo with the 3 public keys above.\n\nⓘ Many account-based assets, including Ethereum, require you to [Fund Gas Tanks](https://developers.bitgo.com/docs/get-started-gas-tanks) to initialize new wallets on chain. Ensure your gas tank has a sufficient balance to cover this cost before generating a new wallet.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"label\": \"My Wallet\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"multisigType\": \"onchain\",\n \"type\": \"custodial\",\n \"passphrase\": \"string\",\n \"userKey\": \"string\",\n \"backupXpub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"backupXpubProvider\": \"dai\",\n \"disableTransactionNotifications\": true,\n \"passcodeEncryptionCode\": \"string\",\n \"coldDerivationSeed\": \"string\",\n \"gasPrice\": 1888,\n \"disableKRSEmail\": false,\n \"walletVersion\": 1,\n \"isDistributedCustody\": false,\n \"bitgoKeyId\": \"59cd72485007a239fb00282ed480da1f\",\n \"commonKeychain\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/generate?includeKeychains=false", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "generate" ], "query": [ { "key": "includeKeychains", "value": "false" } ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"wallet\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"users\": [\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"string\"\n ]\n }\n ],\n \"coin\": \"tbtc4\",\n \"label\": \"My TBTC4 Wallet\",\n \"m\": 2,\n \"n\": 3,\n \"keys\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"keySignatures\": {\n \"backupPub\": \"1fe81d0c91457d89993b01475bfb9e5809067ae046926faeab6e63beea009d8dd460387e0c3843034570798a9c2bcc1dbbea2988ee5a36979e0bbe6e02f7840af2\",\n \"bitgoPub\": \"209d0e9a6d4352b66fae0a35ce62c1059bcc4db9e2883abc4f1b3d20481c5cebb7299c581efd9e0151abaf2496da7c6d75d276de36ed3de37c94e9cc5a2ea77e59\"\n },\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"receiveAddress\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 5539,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1989-05-20T09:17:59.035Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 9517,\n \"totalSent\": 3160,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n },\n \"balance\": 0,\n \"balanceString\": \"0\",\n \"confirmedBalance\": 0,\n \"confirmedBalanceString\": \"0\",\n \"spendableBalance\": 0,\n \"spendableBalanceString\": \"0\",\n \"deleted\": false,\n \"isCold\": false,\n \"freeze\": {},\n \"disableTransactionNotifications\": false,\n \"admin\": {},\n \"approvalsRequired\": 1,\n \"allowBackupKeySigning\": false,\n \"coinSpecific\": {},\n \"clientFlags\": [\n \"string\"\n ],\n \"recoverable\": true,\n \"startDate\": \"2020-12-15T15:42:00.548Z\",\n \"hasLargeNumberOfAddresses\": false,\n \"config\": {}\n },\n \"encryptedWalletPassphrase\": \"\\\"{\\\\\\\"iv\\\\\\\":\\\\\\\"IpwAFi0+TDsLJCV4pg8T6w==\\\\\\\",\\\\\\\"v\\\\\\\":1,\\\\\\\"iter\\\\\\\":10000,\\\\\\\"ks\\\\\\\":256,\\\\\\\"ts\\\\\\\":64,\\\\\\\"mode\\\\\\\":\\\\\\\"ccm\\\\\\\",\\\\\\\"adata\\\\\\\":\\\\\\\"\\\\\\\",\\\\\\\"cipher\\\\\\\":\\\\\\\"aes\\\\\\\",\\\\\\\"salt\\\\\\\":\\\\\\\"3lkIc47rjzo=\\\\\\\",\\\\\\\"ct\\\\\\\":\\\\\\\"/m6JL/ttTJWXNmHm+dzI\\\\\\\"}\\\"\",\n \"userKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"encryptedPrv\": \"{\\\"iv\\\":\\\"TEd5eouui6hKashuVi5WHQ==\\\",\\\"v\\\":1,\\\"iter\\\":10000,\\\"ks\\\":256,\\\"ts\\\":64,\\\"mode\\\":\\\"ccm\\\",\\\"adata\\\":\\\"\\\",\\\"cipher\\\":\\\"aes\\\",\\\"salt\\\":\\\"dHu4PWoX2M8=\\\",\\\"ct\\\":\\\"fYr9Y/6kU40AosONkV0xi+fWsyhpYSew0L2YKH/qEZjOlxeDjpC2aTJ0Yc/KdmXheUGolcAxGSx93ykN21Zim1DGc/UGa25IUA/3ARgX7gBsYnYEy5e5Ol0YZYb9pa7KFeaDZSLMXrxxoahg5zL4AJsUx90Pwcg=\\\"}\",\n \"prv\": \"xprv9s21ZrQH143K3e1981rUcbKjJ9G57SDCDZ9HY4Sqhx5ZqMoyK1j49kAf1vuM1G9nhRr6kzqbUQb3gj5zuzrsvNRQ84tYf32EcyapRgBNpp4\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"ethAddress\": \"0xf5b7cca8621691f9dde304cb7128b6bb3d409363\",\n \"source\": \"user\",\n \"coinSpecific\": {}\n },\n \"backupKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"prv\": \"xprv9s21ZrQH143K47iEnAFZRJz36E5ZxuEDBJETFYxJTsTVxuPc9z7oGWADUK6icX5P3ruoe244yxMt9uZ2LjWhddvnJJ4zB7zK93qBtxYrmN6\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"source\": \"backup\",\n \"ethAddress\": \"0xf5b7cca8621691f9dde304cb7128b6bb3d409363\",\n \"coinSpecific\": {}\n },\n \"bitgoKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"isBitGo\": true,\n \"source\": \"bitgo\",\n \"ethAddress\": \"0xa487900d0de75107b1cc7ade0e2662980e5ce940\",\n \"coinSpecific\": {}\n },\n \"warning\": \"Be sure to backup the backup keychain -- it is not stored anywhere else!\"\n}" } ] } ] }, { "name": "MPC", "item": [ { "name": "Generate wallet", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"label\": \"My Wallet\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"multisigType\": \"onchain\",\n \"type\": \"custodial\",\n \"passphrase\": \"string\",\n \"userKey\": \"string\",\n \"backupXpub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"backupXpubProvider\": \"dai\",\n \"disableTransactionNotifications\": true,\n \"passcodeEncryptionCode\": \"string\",\n \"coldDerivationSeed\": \"string\",\n \"gasPrice\": 1888,\n \"disableKRSEmail\": false,\n \"walletVersion\": 1,\n \"isDistributedCustody\": false,\n \"bitgoKeyId\": \"59cd72485007a239fb00282ed480da1f\",\n \"commonKeychain\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/generate?includeKeychains=false", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "generate" ], "query": [ { "key": "includeKeychains", "value": "false" } ], "variable": [ { "key": "coin", "value": "btc" } ] }, "description": "Generate a new wallet for a coin. If you want a wallet to hold tokens, generate a wallet for the native coin of the blockchain (e.g. generate an ETH wallet to hold ERC20 tokens).\n\nCalling this endpoint does all of the following:\n\n* Creates the user keychain locally on your machine and encrypts it with the provided passphrase (skipped if you pass a `userKey`).\n* Creates the backup keychain locally on your machine.\n* Uploads the encrypted user keychain and public backup keychain to BitGo.\n* Creates the BitGo key (and the backup key if you pass `backupXpubProvider`) on the service.\n* Creates the wallet on BitGo with the 3 public keys above.\n\nⓘ Many account-based assets, including Ethereum, require you to [Fund Gas Tanks](https://developers.bitgo.com/docs/get-started-gas-tanks) to initialize new wallets on chain. Ensure your gas tank has a sufficient balance to cover this cost before generating a new wallet.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"label\": \"My Wallet\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"multisigType\": \"onchain\",\n \"type\": \"custodial\",\n \"passphrase\": \"string\",\n \"userKey\": \"string\",\n \"backupXpub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"backupXpubProvider\": \"dai\",\n \"disableTransactionNotifications\": true,\n \"passcodeEncryptionCode\": \"string\",\n \"coldDerivationSeed\": \"string\",\n \"gasPrice\": 1888,\n \"disableKRSEmail\": false,\n \"walletVersion\": 1,\n \"isDistributedCustody\": false,\n \"bitgoKeyId\": \"59cd72485007a239fb00282ed480da1f\",\n \"commonKeychain\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/generate?includeKeychains=false", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "generate" ], "query": [ { "key": "includeKeychains", "value": "false" } ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"wallet\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"users\": [\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"string\"\n ]\n }\n ],\n \"coin\": \"tbtc4\",\n \"label\": \"My TBTC4 Wallet\",\n \"m\": 2,\n \"n\": 3,\n \"keys\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"keySignatures\": {\n \"backupPub\": \"1fe81d0c91457d89993b01475bfb9e5809067ae046926faeab6e63beea009d8dd460387e0c3843034570798a9c2bcc1dbbea2988ee5a36979e0bbe6e02f7840af2\",\n \"bitgoPub\": \"209d0e9a6d4352b66fae0a35ce62c1059bcc4db9e2883abc4f1b3d20481c5cebb7299c581efd9e0151abaf2496da7c6d75d276de36ed3de37c94e9cc5a2ea77e59\"\n },\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"receiveAddress\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 5539,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1989-05-20T09:17:59.035Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 9517,\n \"totalSent\": 3160,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n },\n \"balance\": 0,\n \"balanceString\": \"0\",\n \"confirmedBalance\": 0,\n \"confirmedBalanceString\": \"0\",\n \"spendableBalance\": 0,\n \"spendableBalanceString\": \"0\",\n \"deleted\": false,\n \"isCold\": false,\n \"freeze\": {},\n \"disableTransactionNotifications\": false,\n \"admin\": {},\n \"approvalsRequired\": 1,\n \"allowBackupKeySigning\": false,\n \"coinSpecific\": {},\n \"clientFlags\": [\n \"string\"\n ],\n \"recoverable\": true,\n \"startDate\": \"2020-12-15T15:42:00.548Z\",\n \"hasLargeNumberOfAddresses\": false,\n \"config\": {}\n },\n \"encryptedWalletPassphrase\": \"\\\"{\\\\\\\"iv\\\\\\\":\\\\\\\"IpwAFi0+TDsLJCV4pg8T6w==\\\\\\\",\\\\\\\"v\\\\\\\":1,\\\\\\\"iter\\\\\\\":10000,\\\\\\\"ks\\\\\\\":256,\\\\\\\"ts\\\\\\\":64,\\\\\\\"mode\\\\\\\":\\\\\\\"ccm\\\\\\\",\\\\\\\"adata\\\\\\\":\\\\\\\"\\\\\\\",\\\\\\\"cipher\\\\\\\":\\\\\\\"aes\\\\\\\",\\\\\\\"salt\\\\\\\":\\\\\\\"3lkIc47rjzo=\\\\\\\",\\\\\\\"ct\\\\\\\":\\\\\\\"/m6JL/ttTJWXNmHm+dzI\\\\\\\"}\\\"\",\n \"userKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"encryptedPrv\": \"{\\\"iv\\\":\\\"TEd5eouui6hKashuVi5WHQ==\\\",\\\"v\\\":1,\\\"iter\\\":10000,\\\"ks\\\":256,\\\"ts\\\":64,\\\"mode\\\":\\\"ccm\\\",\\\"adata\\\":\\\"\\\",\\\"cipher\\\":\\\"aes\\\",\\\"salt\\\":\\\"dHu4PWoX2M8=\\\",\\\"ct\\\":\\\"fYr9Y/6kU40AosONkV0xi+fWsyhpYSew0L2YKH/qEZjOlxeDjpC2aTJ0Yc/KdmXheUGolcAxGSx93ykN21Zim1DGc/UGa25IUA/3ARgX7gBsYnYEy5e5Ol0YZYb9pa7KFeaDZSLMXrxxoahg5zL4AJsUx90Pwcg=\\\"}\",\n \"prv\": \"xprv9s21ZrQH143K3e1981rUcbKjJ9G57SDCDZ9HY4Sqhx5ZqMoyK1j49kAf1vuM1G9nhRr6kzqbUQb3gj5zuzrsvNRQ84tYf32EcyapRgBNpp4\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"ethAddress\": \"0xf5b7cca8621691f9dde304cb7128b6bb3d409363\",\n \"source\": \"user\",\n \"coinSpecific\": {}\n },\n \"backupKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"prv\": \"xprv9s21ZrQH143K47iEnAFZRJz36E5ZxuEDBJETFYxJTsTVxuPc9z7oGWADUK6icX5P3ruoe244yxMt9uZ2LjWhddvnJJ4zB7zK93qBtxYrmN6\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"source\": \"backup\",\n \"ethAddress\": \"0xf5b7cca8621691f9dde304cb7128b6bb3d409363\",\n \"coinSpecific\": {}\n },\n \"bitgoKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"isBitGo\": true,\n \"source\": \"bitgo\",\n \"ethAddress\": \"0xa487900d0de75107b1cc7ade0e2662980e5ce940\",\n \"coinSpecific\": {}\n },\n \"warning\": \"Be sure to backup the backup keychain -- it is not stored anywhere else!\"\n}" } ] } ] } ] }, { "name": "Configure Admin Approval Policy", "item": [ { "name": "Create policy rule", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] }, "description": "Creates a new policy rule." }, "response": [ { "name": "The newly created policy rule", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"uniqueId\": \"c3ff569e-e30a-4405-8b76-38de240c724a\",\n \"id\": \"4fa8326b-4f5f-4065-8cfc-85a08c290c49\",\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"status\": \"ACTIVE\",\n \"version\": 1,\n \"adminOnly\": false,\n \"touchpointLabel\": \"Transfer from a Segregated Wallet\",\n \"scopeLabel\": \"Wallet\",\n \"clauses\": [\n {\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ],\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n },\n \"name\": \"wallet.ids\"\n }\n ],\n \"locked\": true,\n \"lockType\": \"PERMANENT\",\n \"enterpriseId\": \"5d1a5f2c8f0a9c001a5f2c8f0ad00000\",\n \"lastTriggeredDate\": \"2023-11-13T14:49:48.830522Z\",\n \"lastTriggeredEvaluationId\": \"306258df-dcab-489e-a9fe-ff28ce9fa312\",\n \"createdBy\": \"5d1a5f2c8f0a9c001a5f2c8f0ad00000\",\n \"modifiedBy\": \"5d1a5f2c8f0a9c001a5f2c8f0ad00000\",\n \"evaluationId\": \"306258df-dcab-489e-a9fe-ff28ce9fa312\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"BadRequest\",\n \"message\": \"Bad Request\",\n \"status\": 400\n}" }, { "name": "Unauthorized", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"Unauthorized\",\n \"message\": \"Unauthorized\",\n \"status\": 401\n}" }, { "name": "Forbidden", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"AccessDenied\",\n \"message\": \"License not added for enterprise\",\n \"status\": 403\n}" }, { "name": "The specified resource was not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"NotFound\",\n \"message\": \"Touchpoint not found\",\n \"status\": 404\n}" }, { "name": "Server Error - Transient error please try again", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Get approval if transferring more than 2 BTC in a minute\",\n \"adminOnly\": false,\n \"clauses\": [\n {\n \"conditions\": [\n {\n \"name\": \"transfer.velocity.limit\",\n \"parameters\": {\n \"amount\": \"2000000\",\n \"timeWindow\": \"60\",\n \"coin\": \"btc\"\n }\n }\n ],\n \"actions\": [\n {\n \"name\": \"approvals.customer.walletAdmin\",\n \"parameters\": {}\n }\n ]\n }\n ],\n \"filteringConditions\": [\n {\n \"name\": \"wallet.ids\",\n \"parameters\": {\n \"walletId\": [\n \"643f146bb13653000765c478a384a656\"\n ]\n }\n }\n ],\n \"lockType\": \"LOCK_AFTER_DATE\",\n \"lockDate\": \"2023-11-13T14:49:48.830522Z\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/policy/v1/enterprises/:enterpriseId/touchpoints/:touchpointName/rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "policy", "v1", "enterprises", ":enterpriseId", "touchpoints", ":touchpointName", "rules" ], "variable": [ { "key": "enterpriseId", "value": "63c86bf4555aba000652d5c59aff2866", "description": "Your Enterprise Id." }, { "key": "touchpointName", "value": "wallet.segregated.transfer", "description": "The name of the Touchpoint." } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"code\": \"Internal_Server_Error\",\n \"message\": \"Database is down\",\n \"status\": 500\n}" } ] } ] }, { "name": "Withdrawal Flow", "item": [ { "name": "Multisig Hot Simple", "item": [ { "name": "Send transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\",\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 327,\n \"feeRate\": 10000,\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": \"96\",\n \"minConfirms\": 7913,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 123,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 99815686819,\n \"maxFeePerGas\": \"2000000\"\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 6961,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 4388,\n \"ledgerSequenceDelta\": 8956,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 32,\n \"validToBlock\": 4903,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": \"2000000\",\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2006-11-18T12:51:20.493Z\"\n },\n \"data\": \"string\",\n \"hop\": true,\n \"tokenName\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/sendcoins", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "sendcoins" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "This call allows you to create and send cryptocurrency to a destination address." }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\",\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 327,\n \"feeRate\": 10000,\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": \"96\",\n \"minConfirms\": 7913,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 123,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 99815686819,\n \"maxFeePerGas\": \"2000000\"\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 6961,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 4388,\n \"ledgerSequenceDelta\": 8956,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 32,\n \"validToBlock\": 4903,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": \"2000000\",\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2006-11-18T12:51:20.493Z\"\n },\n \"data\": \"string\",\n \"hop\": true,\n \"tokenName\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/sendcoins", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "sendcoins" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1967-05-05T11:22:42.204Z\",\n \"info\": {\n \"transactionRequestFull\": {\n \"txRequestId\": \"string\",\n \"policyUniqueId\": \"59cd72485007a239fb00282ed480da1f\",\n \"verificationItems\": [\n \"string\"\n ],\n \"verificationRuleId\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"walletRebalanceEventId\": \"59cd72485007a239fb00282ed480da1f\",\n \"txRequest\": {\n \"txRequestId\": \"string\",\n \"version\": 6918.748869666562,\n \"latest\": true,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1955-07-06T22:07:34.509Z\",\n \"createdDate\": \"2024-09-29T02:56:52.196Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"selfSend\": true,\n \"intentType\": \"delegate\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": true,\n \"key_1\": 6181\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": 878.6515362192482,\n \"feeOptions\": {\n \"gasLimit\": 9500.210772588838,\n \"maxFeePerGas\": 6354.904469040721,\n \"maxPriorityFeePerGas\": 7350.489763504802\n },\n \"hopParams\": {\n \"gasPriceMax\": 3258.0717512945603,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 3445.358291797758\n }\n ],\n \"walletType\": \"custodial\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"validatorAddress\": \"string\",\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"intentType\": \"unstake\",\n \"stakingRequestId\": \"string\",\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": 4210.186015664796\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": true,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 2355.083999737857,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": true,\n \"value\": 9324.324970791233,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": true,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 1991.3652546282945,\n \"derivationIndex\": 9281.894852972193,\n \"address\": \"string\",\n \"chain\": 8297.70884398829,\n \"index\": 4170.201840099652\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n }\n },\n \"type\": \"transactionRequestFull\"\n },\n \"state\": \"pendingVideoApproval\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Accepted", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\",\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 327,\n \"feeRate\": 10000,\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": \"96\",\n \"minConfirms\": 7913,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 123,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 99815686819,\n \"maxFeePerGas\": \"2000000\"\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 6961,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 4388,\n \"ledgerSequenceDelta\": 8956,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 32,\n \"validToBlock\": 4903,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": \"2000000\",\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2006-11-18T12:51:20.493Z\"\n },\n \"data\": \"string\",\n \"hop\": true,\n \"tokenName\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/sendcoins", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "sendcoins" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1967-05-05T11:22:42.204Z\",\n \"info\": {\n \"transactionRequestFull\": {\n \"txRequestId\": \"string\",\n \"policyUniqueId\": \"59cd72485007a239fb00282ed480da1f\",\n \"verificationItems\": [\n \"string\"\n ],\n \"verificationRuleId\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"walletRebalanceEventId\": \"59cd72485007a239fb00282ed480da1f\",\n \"txRequest\": {\n \"txRequestId\": \"string\",\n \"version\": 6918.748869666562,\n \"latest\": true,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1955-07-06T22:07:34.509Z\",\n \"createdDate\": \"2024-09-29T02:56:52.196Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"selfSend\": true,\n \"intentType\": \"delegate\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": true,\n \"key_1\": 6181\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": 878.6515362192482,\n \"feeOptions\": {\n \"gasLimit\": 9500.210772588838,\n \"maxFeePerGas\": 6354.904469040721,\n \"maxPriorityFeePerGas\": 7350.489763504802\n },\n \"hopParams\": {\n \"gasPriceMax\": 3258.0717512945603,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 3445.358291797758\n }\n ],\n \"walletType\": \"custodial\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"validatorAddress\": \"string\",\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"intentType\": \"unstake\",\n \"stakingRequestId\": \"string\",\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": 4210.186015664796\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": true,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 2355.083999737857,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": true,\n \"value\": 9324.324970791233,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": true,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 1991.3652546282945,\n \"derivationIndex\": 9281.894852972193,\n \"address\": \"string\",\n \"chain\": 8297.70884398829,\n \"index\": 4170.201840099652\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n }\n },\n \"type\": \"transactionRequestFull\"\n },\n \"state\": \"pendingVideoApproval\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\",\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 327,\n \"feeRate\": 10000,\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": \"96\",\n \"minConfirms\": 7913,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 123,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 99815686819,\n \"maxFeePerGas\": \"2000000\"\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 6961,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 4388,\n \"ledgerSequenceDelta\": 8956,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 32,\n \"validToBlock\": 4903,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": \"2000000\",\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2006-11-18T12:51:20.493Z\"\n },\n \"data\": \"string\",\n \"hop\": true,\n \"tokenName\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/sendcoins", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "sendcoins" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Update pending approval", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Updates the state of a pending approval to `approved` or `rejected`.\nYou can manage pending approvals programmatically by API or with the\nBigGo web UI. Ensure your authentication token has the proper scope.\nWhen creating an access token in the web UI, check the permission,\n\"Update Pending Approvals\" (under \"Account Settings\" > \"Developer\nOptions\" > \"Access Tokens\").\n\nBitGo recommends that you create a webhook policy so that you can\nautomate approving and rejecting transactions.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Accepted", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" } ] } ] }, { "name": "Multisig Hot Manual", "item": [ { "name": "Build a transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ],\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 585,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"-931\",\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 7046,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 8463,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": \"2000000\",\n \"maxFeePerGas\": 6348\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 5741,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 1826,\n \"ledgerSequenceDelta\": 3076,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 8925,\n \"validToBlock\": 2184,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": 1892,\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2021-10-28T16:58:52.378Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/build?destinationTag=string", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "build" ], "query": [ { "key": "destinationTag", "value": "string", "description": "Required when sending to a BitGo wallet.\n" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Build a transaction from the wallet using provided options. Use only with multisignature wallets. For MPC wallets, use [Create transaction request](/reference/v2wallettxrequestcreate). If you want to build, sign, and send all in one call, use [Send transaction](/reference/expresswalletsendcoins).\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ],\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 585,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"-931\",\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 7046,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 8463,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": \"2000000\",\n \"maxFeePerGas\": 6348\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 5741,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 1826,\n \"ledgerSequenceDelta\": 3076,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 8925,\n \"validToBlock\": 2184,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": 1892,\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2021-10-28T16:58:52.378Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/build?destinationTag=string", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "build" ], "query": [ { "description": "Required when sending to a BitGo wallet.\n", "key": "destinationTag", "value": "string" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"keyDerivationPath\": \"string\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ],\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 585,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"-931\",\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 7046,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 8463,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": \"2000000\",\n \"maxFeePerGas\": 6348\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 5741,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 1826,\n \"ledgerSequenceDelta\": 3076,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 8925,\n \"validToBlock\": 2184,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": 1892,\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2021-10-28T16:58:52.378Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/build?destinationTag=string", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "build" ], "query": [ { "description": "Required when sending to a BitGo wallet.\n", "key": "destinationTag", "value": "string" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Sign transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"prv\": \"xprv9s21ZrQH143K3xQwj4yx3fHjDieEdqFDweBvFxn28qGvfQGvweUWuUuDRpepDu6opq3jiWHU9h3yYTKk5vvu4ykRuGA4i4Kz1vmFMPLTsoC\",\n \"txPrebuild\": {\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"txHex\": \"string\",\n \"txBase64\": \"string\",\n \"txInfo\": {\n \"changeAddresses\": [\n \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n ],\n \"nOutputs\": 2,\n \"nP2SHInputs\": 0,\n \"nSegwitInputs\": 1,\n \"unspents\": [\n {\n \"id\": \"003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2\",\n \"address\": \"2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2\",\n \"value\": 624,\n \"valueString\": \"2000000\",\n \"blockHeight\": 8676,\n \"date\": \"2017-03-25T23:01:40.248Z\",\n \"coinbase\": true,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"fromWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"chain\": 0,\n \"index\": 6464,\n \"redeemScript\": \"522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae\",\n \"witnessScript\": \"52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae\",\n \"isSegwit\": true\n },\n {\n \"id\": \"003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2\",\n \"address\": \"2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2\",\n \"value\": 9515,\n \"valueString\": \"2000000\",\n \"blockHeight\": 1272,\n \"date\": \"2017-03-25T23:01:40.248Z\",\n \"coinbase\": true,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"fromWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"chain\": 0,\n \"index\": 6117,\n \"redeemScript\": \"522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae\",\n \"witnessScript\": \"52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae\",\n \"isSegwit\": true\n }\n ],\n \"walletAddressDetails\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 4509,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1999-08-18T11:13:15.763Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 5225,\n \"totalSent\": 2738,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n }\n },\n \"feeInfo\": {\n \"size\": 776,\n \"fee\": 38800,\n \"feeRate\": \"string\",\n \"payGoFee\": 0,\n \"payGoFeeString\": 1841\n }\n },\n \"isLastSignature\": true,\n \"pubs\": [\n \"string\",\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/signtx", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "signtx" ], "variable": [ { "key": "coin", "value": "btc" } ] }, "description": "This route is for users who would like to maintain their own keys, or otherwise would not like BitGo to decrypt their key, and instead provide it in the clear themselves" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"prv\": \"xprv9s21ZrQH143K3xQwj4yx3fHjDieEdqFDweBvFxn28qGvfQGvweUWuUuDRpepDu6opq3jiWHU9h3yYTKk5vvu4ykRuGA4i4Kz1vmFMPLTsoC\",\n \"txPrebuild\": {\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"txHex\": \"string\",\n \"txBase64\": \"string\",\n \"txInfo\": {\n \"changeAddresses\": [\n \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n ],\n \"nOutputs\": 2,\n \"nP2SHInputs\": 0,\n \"nSegwitInputs\": 1,\n \"unspents\": [\n {\n \"id\": \"003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2\",\n \"address\": \"2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2\",\n \"value\": 624,\n \"valueString\": \"2000000\",\n \"blockHeight\": 8676,\n \"date\": \"2017-03-25T23:01:40.248Z\",\n \"coinbase\": true,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"fromWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"chain\": 0,\n \"index\": 6464,\n \"redeemScript\": \"522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae\",\n \"witnessScript\": \"52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae\",\n \"isSegwit\": true\n },\n {\n \"id\": \"003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2\",\n \"address\": \"2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2\",\n \"value\": 9515,\n \"valueString\": \"2000000\",\n \"blockHeight\": 1272,\n \"date\": \"2017-03-25T23:01:40.248Z\",\n \"coinbase\": true,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"fromWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"chain\": 0,\n \"index\": 6117,\n \"redeemScript\": \"522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae\",\n \"witnessScript\": \"52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae\",\n \"isSegwit\": true\n }\n ],\n \"walletAddressDetails\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 4509,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1999-08-18T11:13:15.763Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 5225,\n \"totalSent\": 2738,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n }\n },\n \"feeInfo\": {\n \"size\": 776,\n \"fee\": 38800,\n \"feeRate\": \"string\",\n \"payGoFee\": 0,\n \"payGoFeeString\": 1841\n }\n },\n \"isLastSignature\": true,\n \"pubs\": [\n \"string\",\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/signtx", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "signtx" ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txInfo\": {\n \"halfSigned\": {\n \"txBase64\": \"AAAAAGRnXg19FteG/7zPd+jDC7LDvRlzgfFC+JrPhRep0kYiAAAAZAB/4cUAAAACAAAAAAAAAAAAAAABAAAAAQAAAABkZ14NfRbXhv+8z3fowwuyw70Zc4HxQviaz4UXqdJGIgAAAAEAAAAAmljT/+FedddnAHwo95dOC4RNy6eVLSehaJY34b9GxuYAAAAAAAAAAAehIAAAAAAAAAAAAUrgwAkAAABAOExcvVJIUJv9HuVfbV0y7lRPRARv4wDtcdhHG7QN40h5wQ2uwPF52OGQ8KY+66a1A/8lNKB75sgj2xj44s8lDQ==\"\n }\n }\n}" } ] }, { "name": "Send a half-signed transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Send a half-signed transaction to BitGo for final signing (using the BitGo key) and broadcasting.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"transfer\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"txid\": \"b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26\",\n \"height\": 5127,\n \"date\": \"1974-04-04T11:00:58.742Z\",\n \"confirmations\": 934,\n \"type\": \"receive\",\n \"valueString\": \"2000000\",\n \"usd\": 9704.460165178576,\n \"usdRate\": 2341.9817682783296,\n \"state\": \"confirmed\",\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"history\": [\n {\n \"date\": \"1996-05-25T15:15:26.755Z\",\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"action\": \"signed\",\n \"comment\": \"string\"\n },\n {\n \"date\": \"1993-11-27T15:53:26.831Z\",\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"action\": \"commented\",\n \"comment\": \"string\"\n }\n ],\n \"comment\": \"string\",\n \"coinSpecific\": {},\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"txidType\": \"blockHash\",\n \"heightId\": \"string\",\n \"value\": 5125,\n \"intendedValueString\": \"2000000\",\n \"baseValue\": 9328,\n \"baseValueString\": \"2000000\",\n \"baseValueWithoutFees\": 6188,\n \"baseValueWithoutFeesString\": \"2000000\",\n \"feeString\": \"string\",\n \"payGoFee\": 4304,\n \"payGoFeeString\": \"string\",\n \"vSize\": 6614,\n \"sequenceId\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"txRequestId\": \"string\",\n \"goStakingRequestId\": \"string\",\n \"subType\": \"ofc_withdrawal\",\n \"feeCoin\": \"string\",\n \"instant\": true,\n \"instantId\": \"string\",\n \"isFee\": true,\n \"isReward\": true,\n \"isUnlock\": true,\n \"metadata\": [\n {\n \"key\": \"string\",\n \"value\": \"string\"\n },\n {\n \"key\": \"string\",\n \"value\": \"string\"\n }\n ],\n \"sendAccounting\": [\n {\n \"type\": \"string\",\n \"amountString\": \"string\",\n \"nOuts\": 7913,\n \"amount\": 8642,\n \"id\": \"string\"\n },\n {\n \"type\": \"string\",\n \"amountString\": \"string\",\n \"nOuts\": 7393,\n \"amount\": 7521,\n \"id\": \"string\"\n }\n ],\n \"createdTime\": \"1987-04-29T19:45:11.614Z\",\n \"approvedTime\": \"2015-09-04T08:47:21.644Z\",\n \"rejectedTime\": \"2015-01-15T14:30:48.981Z\",\n \"signedTime\": \"1964-07-01T14:16:39.183Z\",\n \"unconfirmedTime\": \"2023-04-03T20:37:53.290Z\",\n \"confirmedTime\": \"2014-04-12T07:29:27.159Z\",\n \"removedTime\": \"1970-01-19T01:25:07.260Z\",\n \"commentedTime\": \"2017-06-14T10:44:02.873Z\",\n \"failedTime\": \"2012-02-09T19:51:52.385Z\",\n \"regeneratedTime\": \"2017-11-02T10:34:29.306Z\",\n \"replacedTime\": \"1971-08-08T23:37:11.498Z\",\n \"replacingTime\": \"1988-05-03T09:31:39.351Z\",\n \"abandonedTime\": \"1957-03-31T17:50:03.204Z\",\n \"signedDate\": \"1969-01-12T04:14:25.473Z\",\n \"customerApprovedTime\": \"2021-11-09T04:39:48.878Z\",\n \"idVerificationTime\": \"1947-06-01T15:56:28.137Z\",\n \"trustSignedTime\": \"1985-04-11T17:15:50.227Z\",\n \"trustFinalApprovalTime\": \"1976-08-26T23:02:59.123Z\",\n \"walletLabel\": \"string\",\n \"enterpriseName\": \"string\",\n \"elliptic\": \"string\",\n \"senderInformationVerified\": false,\n \"buildParams\": {\n \"key_0\": 1115\n },\n \"entries\": [\n {\n \"address\": \"2NAUwNgXaoFj2VVnSEvNLGuez8CfdU2UCMZ\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"value\": 1438,\n \"valueString\": \"2000000\",\n \"isChange\": true,\n \"isPayGo\": true,\n \"token\": \"omg\",\n \"label\": \"string\",\n \"failed\": true,\n \"associatedNativeCoinAddress\": \"string\",\n \"memo\": \"string\",\n \"type\": \"string\",\n \"nftId\": \"string\",\n \"nftSymbol\": \"string\"\n },\n {\n \"address\": \"2NAUwNgXaoFj2VVnSEvNLGuez8CfdU2UCMZ\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"value\": 8254,\n \"valueString\": \"2000000\",\n \"isChange\": false,\n \"isPayGo\": false,\n \"token\": \"omg\",\n \"label\": \"string\",\n \"failed\": false,\n \"associatedNativeCoinAddress\": \"string\",\n \"memo\": \"string\",\n \"type\": \"string\",\n \"nftId\": \"string\",\n \"nftSymbol\": \"string\"\n }\n ],\n \"usersNotified\": true,\n \"label\": \"string\",\n \"replaces\": [\n \"string\",\n \"string\"\n ],\n \"replacedBy\": [\n \"string\",\n \"string\"\n ],\n \"riskIndicators\": [\n \"SELFDESTRUCT\",\n \"SELFDESTRUCT\"\n ]\n },\n \"txid\": \"string\",\n \"tx\": \"string\",\n \"status\": \"confirmed\"\n}" }, { "name": "Accepted", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1989-05-31T09:35:58.829Z\",\n \"info\": {\n \"policyRuleRequest\": {\n \"action\": \"string\",\n \"updateEnterpriseRequest\": {\n \"type\": \"updateEnterpriseRequest\",\n \"action\": \"remove\",\n \"permission\": \"admin\",\n \"userId\": \"string\",\n \"email\": \"user@example.com\"\n }\n },\n \"type\": \"policyRuleRequest\"\n },\n \"state\": \"approved\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"pendingVideoApproval\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Locked", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Locked (WebDAV) (RFC 4918)", "code": 423, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\"\n}" } ] }, { "name": "Update pending approval", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Updates the state of a pending approval to `approved` or `rejected`.\nYou can manage pending approvals programmatically by API or with the\nBigGo web UI. Ensure your authentication token has the proper scope.\nWhen creating an access token in the web UI, check the permission,\n\"Update Pending Approvals\" (under \"Account Settings\" > \"Developer\nOptions\" > \"Access Tokens\").\n\nBitGo recommends that you create a webhook policy so that you can\nautomate approving and rejecting transactions.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Accepted", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" } ] } ] }, { "name": "MPC Hot Simple", "item": [ { "name": "Create a signature share for the transaction request", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Allows users to supply their signature share for signing. Use only with MPC wallets." }, "response": [ { "name": "Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Unauthorized", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Forbidden", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Not Found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Get transaction requests by wallet", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests?txRequestIds=string&txRequestIds=string&idempotencyKeys=string&idempotencyKeys=string&sequenceIds=string&sequenceIds=string&intentTypes=vote&intentTypes=stake&excludeIntentTypes=vote&excludeIntentTypes=authorize&states=readyToSend&states=canceled&latest=true&limit=25&prevId=59cd72485007a239fb00282ed480da1f&version=string&sortBy=createdDate&sortDirection=DESC&dateLt=1955-03-29T11:27:49.387Z&dateGte=1955-03-29T11:27:49.387Z&includeEvmKeyringTxRequests=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "query": [ { "key": "txRequestIds", "value": "string", "description": "If provided, only the specified transaction requests will be returned." }, { "key": "txRequestIds", "value": "string", "description": "If provided, only the specified transaction requests will be returned." }, { "key": "idempotencyKeys", "value": "string", "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned." }, { "key": "idempotencyKeys", "value": "string", "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned." }, { "key": "sequenceIds", "value": "string", "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly." }, { "key": "sequenceIds", "value": "string", "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly." }, { "key": "intentTypes", "value": "vote", "description": "If provided, only transaction requests with the specified intent types will be returned." }, { "key": "intentTypes", "value": "stake", "description": "If provided, only transaction requests with the specified intent types will be returned." }, { "key": "excludeIntentTypes", "value": "vote", "description": "If provided, transaction requests with the specified intent types will be excluded." }, { "key": "excludeIntentTypes", "value": "authorize", "description": "If provided, transaction requests with the specified intent types will be excluded." }, { "key": "states", "value": "readyToSend", "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document." }, { "key": "states", "value": "canceled", "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document." }, { "key": "latest", "value": "true", "description": "If provided, only the latest transaction request version will be returned." }, { "key": "limit", "value": "25", "description": "Maximum number of results to return. If the result set is truncated, use the \"nextBatchPrevId\" value to get the next batch." }, { "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f", "description": "Return the next batch of results, based on the \"nextBatchPrevId\" value from the previous batch." }, { "key": "version", "value": "string" }, { "key": "sortBy", "value": "createdDate", "description": "Sorts by specified field, default sorting by id." }, { "key": "sortDirection", "value": "DESC", "description": "Sorts order by field in specified sort direction, default ascending." }, { "key": "dateLt", "value": "1955-03-29T11:27:49.387Z", "description": "Optional get transaction requests less than date" }, { "key": "dateGte", "value": "1955-03-29T11:27:49.387Z", "description": "Optional get transaction requests greater than or equal to date" }, { "key": "includeEvmKeyringTxRequests", "value": "true", "description": "If true, include transaction requests for all EVM keyring related wallets (main + derived)." } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Get a paginated list of transaction requests filtered by wallet. Use only with MPC wallets." }, "response": [ { "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests?txRequestIds=string&idempotencyKeys=string&sequenceIds=string&intentTypes=stake&excludeIntentTypes=authorize&states=canceled&latest=true&limit=25&prevId=59cd72485007a239fb00282ed480da1f&version=string&sortBy=createdDate&sortDirection=DESC&dateLt=1955-03-29T11:27:49.387Z&dateGte=1955-03-29T11:27:49.387Z&includeEvmKeyringTxRequests=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "query": [ { "description": "If provided, only the specified transaction requests will be returned.", "key": "txRequestIds", "value": "string" }, { "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned.", "key": "idempotencyKeys", "value": "string" }, { "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly.", "key": "sequenceIds", "value": "string" }, { "description": "If provided, only transaction requests with the specified intent types will be returned.", "key": "intentTypes", "value": "stake" }, { "description": "If provided, transaction requests with the specified intent types will be excluded.", "key": "excludeIntentTypes", "value": "authorize" }, { "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document.", "key": "states", "value": "canceled" }, { "description": "If provided, only the latest transaction request version will be returned.", "key": "latest", "value": "true" }, { "description": "Maximum number of results to return. If the result set is truncated, use the \"nextBatchPrevId\" value to get the next batch.", "key": "limit", "value": "25" }, { "description": "Return the next batch of results, based on the \"nextBatchPrevId\" value from the previous batch.", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "key": "version", "value": "string" }, { "description": "Sorts by specified field, default sorting by id.", "key": "sortBy", "value": "createdDate" }, { "description": "Sorts order by field in specified sort direction, default ascending.", "key": "sortDirection", "value": "DESC" }, { "description": "Optional get transaction requests less than date", "key": "dateLt", "value": "1955-03-29T11:27:49.387Z" }, { "description": "Optional get transaction requests greater than or equal to date", "key": "dateGte", "value": "1955-03-29T11:27:49.387Z" }, { "description": "If true, include transaction requests for all EVM keyring related wallets (main + derived).", "key": "includeEvmKeyringTxRequests", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequests\": [\n {\n \"txRequestId\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"walletId\": \"59cd72485007a239fb00282ed480da1f\",\n \"version\": 9285.260540694975,\n \"state\": \"pendingUserGShare\",\n \"date\": \"2021-01-01T00:00:00.000Z\",\n \"createdDate\": \"2021-01-01T00:00:00.000Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n \"\"\n ],\n \"latest\": false,\n \"intent\": {\n \"validatorAddress\": \"string\",\n \"requestNumber\": 3086.7632390611234,\n \"intentType\": \"switchValidator\",\n \"stakingRequestId\": \"string\",\n \"amount\": {\n \"symbol\": \"string\",\n \"value\": \"string\"\n },\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n },\n \"unsignedTxs\": [\n {\n \"parsedTx\": {\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"_id\": \"string\",\n \"address\": \"string\",\n \"chain\": 1391.0265925246756,\n \"derivationIndex\": 2345.8880575952603,\n \"index\": 8639.532314039656,\n \"value\": 7241.498296807454\n }\n ],\n \"minerFee\": 3320.6489077600486,\n \"outputs\": [\n {\n \"valueString\": \"string\",\n \"address\": \"string\",\n \"change\": true,\n \"coinName\": \"string\",\n \"data\": \"string\",\n \"isPayGo\": true,\n \"value\": 8275.400575685344,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\"\n }\n ],\n \"spendAmount\": 4902.887255460435,\n \"gasPrice\": 9023.708800840164,\n \"hasUnvalidatedData\": false,\n \"payGoFee\": \"string\",\n \"spendAmounts\": [\n {\n \"key_0\": 5504.458893319175,\n \"key_1\": 5071.6968297837075\n }\n ],\n \"type\": \"string\"\n },\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"coinSpecific\": {\n \"nonceAddress\": \"string\",\n \"stakingAddress\": \"string\",\n \"signature\": \"string\",\n \"key_0\": \"string\"\n },\n \"feeInfo\": {\n \"fee\": \"string\",\n \"feeString\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"vssProof\": \"string\",\n \"privateShareProof\": \"string\",\n \"publicShare\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"type\": \"commitment\",\n \"from\": \"user\",\n \"to\": \"backup\",\n \"share\": \"string\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ],\n \"apiVersion\": \"lite\",\n \"idempotencyKey\": \"string\",\n \"walletType\": \"custodial\",\n \"enterpriseId\": \"59cd72485007a239fb00282ed480da1f\",\n \"pendingApprovalId\": \"string\",\n \"policiesChecked\": false,\n \"isCanceled\": false\n }\n ],\n \"nextBatchPrevId\": \"929f783f-3582-957b-7e74-9a3cff84d161\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests?txRequestIds=string&idempotencyKeys=string&sequenceIds=string&intentTypes=stake&excludeIntentTypes=authorize&states=canceled&latest=true&limit=25&prevId=59cd72485007a239fb00282ed480da1f&version=string&sortBy=createdDate&sortDirection=DESC&dateLt=1955-03-29T11:27:49.387Z&dateGte=1955-03-29T11:27:49.387Z&includeEvmKeyringTxRequests=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "query": [ { "description": "If provided, only the specified transaction requests will be returned.", "key": "txRequestIds", "value": "string" }, { "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned.", "key": "idempotencyKeys", "value": "string" }, { "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly.", "key": "sequenceIds", "value": "string" }, { "description": "If provided, only transaction requests with the specified intent types will be returned.", "key": "intentTypes", "value": "stake" }, { "description": "If provided, transaction requests with the specified intent types will be excluded.", "key": "excludeIntentTypes", "value": "authorize" }, { "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document.", "key": "states", "value": "canceled" }, { "description": "If provided, only the latest transaction request version will be returned.", "key": "latest", "value": "true" }, { "description": "Maximum number of results to return. If the result set is truncated, use the \"nextBatchPrevId\" value to get the next batch.", "key": "limit", "value": "25" }, { "description": "Return the next batch of results, based on the \"nextBatchPrevId\" value from the previous batch.", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "key": "version", "value": "string" }, { "description": "Sorts by specified field, default sorting by id.", "key": "sortBy", "value": "createdDate" }, { "description": "Sorts order by field in specified sort direction, default ascending.", "key": "sortDirection", "value": "DESC" }, { "description": "Optional get transaction requests less than date", "key": "dateLt", "value": "1955-03-29T11:27:49.387Z" }, { "description": "Optional get transaction requests greater than or equal to date", "key": "dateGte", "value": "1955-03-29T11:27:49.387Z" }, { "description": "If true, include transaction requests for all EVM keyring related wallets (main + derived).", "key": "includeEvmKeyringTxRequests", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" }, { "name": "Not Found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests?txRequestIds=string&idempotencyKeys=string&sequenceIds=string&intentTypes=stake&excludeIntentTypes=authorize&states=canceled&latest=true&limit=25&prevId=59cd72485007a239fb00282ed480da1f&version=string&sortBy=createdDate&sortDirection=DESC&dateLt=1955-03-29T11:27:49.387Z&dateGte=1955-03-29T11:27:49.387Z&includeEvmKeyringTxRequests=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "query": [ { "description": "If provided, only the specified transaction requests will be returned.", "key": "txRequestIds", "value": "string" }, { "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned.", "key": "idempotencyKeys", "value": "string" }, { "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly.", "key": "sequenceIds", "value": "string" }, { "description": "If provided, only transaction requests with the specified intent types will be returned.", "key": "intentTypes", "value": "stake" }, { "description": "If provided, transaction requests with the specified intent types will be excluded.", "key": "excludeIntentTypes", "value": "authorize" }, { "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document.", "key": "states", "value": "canceled" }, { "description": "If provided, only the latest transaction request version will be returned.", "key": "latest", "value": "true" }, { "description": "Maximum number of results to return. If the result set is truncated, use the \"nextBatchPrevId\" value to get the next batch.", "key": "limit", "value": "25" }, { "description": "Return the next batch of results, based on the \"nextBatchPrevId\" value from the previous batch.", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "key": "version", "value": "string" }, { "description": "Sorts by specified field, default sorting by id.", "key": "sortBy", "value": "createdDate" }, { "description": "Sorts order by field in specified sort direction, default ascending.", "key": "sortDirection", "value": "DESC" }, { "description": "Optional get transaction requests less than date", "key": "dateLt", "value": "1955-03-29T11:27:49.387Z" }, { "description": "Optional get transaction requests greater than or equal to date", "key": "dateGte", "value": "1955-03-29T11:27:49.387Z" }, { "description": "If true, include transaction requests for all EVM keyring related wallets (main + derived).", "key": "includeEvmKeyringTxRequests", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" } ] }, { "name": "Update pending approval", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Updates the state of a pending approval to `approved` or `rejected`.\nYou can manage pending approvals programmatically by API or with the\nBigGo web UI. Ensure your authentication token has the proper scope.\nWhen creating an access token in the web UI, check the permission,\n\"Update Pending Approvals\" (under \"Account Settings\" > \"Developer\nOptions\" > \"Access Tokens\").\n\nBitGo recommends that you create a webhook policy so that you can\nautomate approving and rejecting transactions.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Accepted", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" } ] } ] }, { "name": "MPC Hot Manual", "item": [ { "name": "Create transaction request", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Allows users to create a transaction request given they have spender permissions on the wallet. Use only with MPC wallets. For multisignature wallets, use [Build a transaction](/reference/v2wallettxbuild)." }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequestId\": \"string\",\n \"version\": 962.564638517922,\n \"latest\": false,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1958-06-05T10:04:39.057Z\",\n \"createdDate\": \"2024-05-29T09:49:46.292Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"intentType\": \"transferStake\",\n \"enableTokens\": [\n {\n \"name\": \"string\",\n \"address\": \"string\"\n }\n ],\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n }\n ],\n \"walletType\": \"advanced\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"selfSend\": true,\n \"intentType\": \"transferReject\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": 5570.607554665372\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"feeOptions\": {\n \"gasLimit\": 295.37930655326505,\n \"maxFeePerGas\": 2882.2355055659887,\n \"maxPriorityFeePerGas\": 8776.593048243323\n },\n \"hopParams\": {\n \"gasPriceMax\": 4342.861276232715,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 4877.688888752396\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": false,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 3677.794523097193,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": false,\n \"value\": 4657.505498904082,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": false,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 464.16276858725735,\n \"derivationIndex\": 7407.991523888358,\n \"address\": \"string\",\n \"chain\": 495.6934451736261,\n \"index\": 9603.794985209446\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n}" }, { "name": "Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequestId\": \"string\",\n \"version\": 962.564638517922,\n \"latest\": false,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1958-06-05T10:04:39.057Z\",\n \"createdDate\": \"2024-05-29T09:49:46.292Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"intentType\": \"transferStake\",\n \"enableTokens\": [\n {\n \"name\": \"string\",\n \"address\": \"string\"\n }\n ],\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n }\n ],\n \"walletType\": \"advanced\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"selfSend\": true,\n \"intentType\": \"transferReject\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": 5570.607554665372\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"feeOptions\": {\n \"gasLimit\": 295.37930655326505,\n \"maxFeePerGas\": 2882.2355055659887,\n \"maxPriorityFeePerGas\": 8776.593048243323\n },\n \"hopParams\": {\n \"gasPriceMax\": 4342.861276232715,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 4877.688888752396\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": false,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 3677.794523097193,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": false,\n \"value\": 4657.505498904082,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": false,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 464.16276858725735,\n \"derivationIndex\": 7407.991523888358,\n \"address\": \"string\",\n \"chain\": 495.6934451736261,\n \"index\": 9603.794985209446\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Unauthorized", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Forbidden", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Not Found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Update pending approval", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Updates the state of a pending approval to `approved` or `rejected`.\nYou can manage pending approvals programmatically by API or with the\nBigGo web UI. Ensure your authentication token has the proper scope.\nWhen creating an access token in the web UI, check the permission,\n\"Update Pending Approvals\" (under \"Account Settings\" > \"Developer\nOptions\" > \"Access Tokens\").\n\nBitGo recommends that you create a webhook policy so that you can\nautomate approving and rejecting transactions.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Accepted", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"otp\": \"string\",\n \"state\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/pendingapprovals/:approvalId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "pendingapprovals", ":approvalId" ], "variable": [ { "key": "approvalId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"2003-10-08T13:27:23.963Z\",\n \"info\": {\n \"transactionRequest\": {\n \"buildParams\": {},\n \"coinSpecific\": {},\n \"comment\": \"string\",\n \"fee\": \"2000000\",\n \"isUnsigned\": true,\n \"recipients\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"data\": \"string\"\n }\n ],\n \"requestedAmount\": \"2000000\",\n \"sourceWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"triggeredPolicy\": \"59cd72485007a239fb00282ed480da1f\",\n \"validTransaction\": \"string\",\n \"validTransactionHash\": \"string\"\n },\n \"type\": \"transactionRequest\"\n },\n \"state\": \"pendingIdVerification\",\n \"scope\": \"enterprise\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"awaitingSignature\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n },\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\",\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n },\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" } ] }, { "name": "Sign MPC transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"txRequestId\": \"string\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/signtxtss", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "signtxtss" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Sign transactions for MPC wallets. If using external-signer mode, you must maintain your keys, in the clear, on a separate Express server - BitGo doesn't decrypt your private MPC key shares." }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"txRequestId\": \"string\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/signtxtss", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "signtxtss" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequestId\": \"string\",\n \"version\": 1436.0992270026563,\n \"latest\": true,\n \"walletId\": \"string\",\n \"state\": \"rejected\",\n \"date\": \"2013-03-18T17:12:57.047Z\",\n \"createdDate\": \"1994-09-04T13:46:31.082Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"intentType\": \"stake\",\n \"stakingRequestId\": \"string\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"options\": {}\n },\n \"amount\": {\n \"value\": \"100\",\n \"symbol\": \"usdc\"\n },\n \"data\": \"string\",\n \"tokenData\": {\n \"tokenType\": \"ERC721\",\n \"tokenQuantity\": \"101\",\n \"tokenContractAddress\": \"0x3d8e90d5F403a0A18dfeeAd36E30EF95D5E1ad3a\",\n \"tokenName\": \"tpolygon:name\",\n \"tokenId\": \"123\",\n \"decimalPlaces\": 18\n }\n }\n ],\n \"sequenceId\": \"abc123\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"memo\": \"string\"\n }\n ],\n \"walletType\": \"custodial\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"validatorAddress\": \"string\",\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"intentType\": \"enableToken\",\n \"stakingRequestId\": \"string\",\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": false,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 3629.323506207951,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": false,\n \"value\": 556.0549624045664,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": false,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 1269.126878824407,\n \"derivationIndex\": 3885.518842419855,\n \"address\": \"string\",\n \"chain\": 8127.4724701773175,\n \"index\": 6137.47357885591\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n}" } ] } ] } ] } ] }, { "name": "Set Up Deposit/Withdraw Wallet", "item": [ { "name": "Create Deposit/Withdraw Wallet", "item": [ { "name": "Multisignature", "item": [ { "name": "Generate wallet", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"label\": \"My Wallet\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"multisigType\": \"onchain\",\n \"type\": \"custodial\",\n \"passphrase\": \"string\",\n \"userKey\": \"string\",\n \"backupXpub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"backupXpubProvider\": \"dai\",\n \"disableTransactionNotifications\": true,\n \"passcodeEncryptionCode\": \"string\",\n \"coldDerivationSeed\": \"string\",\n \"gasPrice\": 1888,\n \"disableKRSEmail\": false,\n \"walletVersion\": 1,\n \"isDistributedCustody\": false,\n \"bitgoKeyId\": \"59cd72485007a239fb00282ed480da1f\",\n \"commonKeychain\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/generate?includeKeychains=false", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "generate" ], "query": [ { "key": "includeKeychains", "value": "false" } ], "variable": [ { "key": "coin", "value": "btc" } ] }, "description": "Generate a new wallet for a coin. If you want a wallet to hold tokens, generate a wallet for the native coin of the blockchain (e.g. generate an ETH wallet to hold ERC20 tokens).\n\nCalling this endpoint does all of the following:\n\n* Creates the user keychain locally on your machine and encrypts it with the provided passphrase (skipped if you pass a `userKey`).\n* Creates the backup keychain locally on your machine.\n* Uploads the encrypted user keychain and public backup keychain to BitGo.\n* Creates the BitGo key (and the backup key if you pass `backupXpubProvider`) on the service.\n* Creates the wallet on BitGo with the 3 public keys above.\n\nⓘ Many account-based assets, including Ethereum, require you to [Fund Gas Tanks](https://developers.bitgo.com/docs/get-started-gas-tanks) to initialize new wallets on chain. Ensure your gas tank has a sufficient balance to cover this cost before generating a new wallet.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"label\": \"My Wallet\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"multisigType\": \"onchain\",\n \"type\": \"custodial\",\n \"passphrase\": \"string\",\n \"userKey\": \"string\",\n \"backupXpub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"backupXpubProvider\": \"dai\",\n \"disableTransactionNotifications\": true,\n \"passcodeEncryptionCode\": \"string\",\n \"coldDerivationSeed\": \"string\",\n \"gasPrice\": 1888,\n \"disableKRSEmail\": false,\n \"walletVersion\": 1,\n \"isDistributedCustody\": false,\n \"bitgoKeyId\": \"59cd72485007a239fb00282ed480da1f\",\n \"commonKeychain\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/generate?includeKeychains=false", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "generate" ], "query": [ { "key": "includeKeychains", "value": "false" } ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"wallet\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"users\": [\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"string\"\n ]\n }\n ],\n \"coin\": \"tbtc4\",\n \"label\": \"My TBTC4 Wallet\",\n \"m\": 2,\n \"n\": 3,\n \"keys\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"keySignatures\": {\n \"backupPub\": \"1fe81d0c91457d89993b01475bfb9e5809067ae046926faeab6e63beea009d8dd460387e0c3843034570798a9c2bcc1dbbea2988ee5a36979e0bbe6e02f7840af2\",\n \"bitgoPub\": \"209d0e9a6d4352b66fae0a35ce62c1059bcc4db9e2883abc4f1b3d20481c5cebb7299c581efd9e0151abaf2496da7c6d75d276de36ed3de37c94e9cc5a2ea77e59\"\n },\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"receiveAddress\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 5539,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1989-05-20T09:17:59.035Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 9517,\n \"totalSent\": 3160,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n },\n \"balance\": 0,\n \"balanceString\": \"0\",\n \"confirmedBalance\": 0,\n \"confirmedBalanceString\": \"0\",\n \"spendableBalance\": 0,\n \"spendableBalanceString\": \"0\",\n \"deleted\": false,\n \"isCold\": false,\n \"freeze\": {},\n \"disableTransactionNotifications\": false,\n \"admin\": {},\n \"approvalsRequired\": 1,\n \"allowBackupKeySigning\": false,\n \"coinSpecific\": {},\n \"clientFlags\": [\n \"string\"\n ],\n \"recoverable\": true,\n \"startDate\": \"2020-12-15T15:42:00.548Z\",\n \"hasLargeNumberOfAddresses\": false,\n \"config\": {}\n },\n \"encryptedWalletPassphrase\": \"\\\"{\\\\\\\"iv\\\\\\\":\\\\\\\"IpwAFi0+TDsLJCV4pg8T6w==\\\\\\\",\\\\\\\"v\\\\\\\":1,\\\\\\\"iter\\\\\\\":10000,\\\\\\\"ks\\\\\\\":256,\\\\\\\"ts\\\\\\\":64,\\\\\\\"mode\\\\\\\":\\\\\\\"ccm\\\\\\\",\\\\\\\"adata\\\\\\\":\\\\\\\"\\\\\\\",\\\\\\\"cipher\\\\\\\":\\\\\\\"aes\\\\\\\",\\\\\\\"salt\\\\\\\":\\\\\\\"3lkIc47rjzo=\\\\\\\",\\\\\\\"ct\\\\\\\":\\\\\\\"/m6JL/ttTJWXNmHm+dzI\\\\\\\"}\\\"\",\n \"userKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"encryptedPrv\": \"{\\\"iv\\\":\\\"TEd5eouui6hKashuVi5WHQ==\\\",\\\"v\\\":1,\\\"iter\\\":10000,\\\"ks\\\":256,\\\"ts\\\":64,\\\"mode\\\":\\\"ccm\\\",\\\"adata\\\":\\\"\\\",\\\"cipher\\\":\\\"aes\\\",\\\"salt\\\":\\\"dHu4PWoX2M8=\\\",\\\"ct\\\":\\\"fYr9Y/6kU40AosONkV0xi+fWsyhpYSew0L2YKH/qEZjOlxeDjpC2aTJ0Yc/KdmXheUGolcAxGSx93ykN21Zim1DGc/UGa25IUA/3ARgX7gBsYnYEy5e5Ol0YZYb9pa7KFeaDZSLMXrxxoahg5zL4AJsUx90Pwcg=\\\"}\",\n \"prv\": \"xprv9s21ZrQH143K3e1981rUcbKjJ9G57SDCDZ9HY4Sqhx5ZqMoyK1j49kAf1vuM1G9nhRr6kzqbUQb3gj5zuzrsvNRQ84tYf32EcyapRgBNpp4\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"ethAddress\": \"0xf5b7cca8621691f9dde304cb7128b6bb3d409363\",\n \"source\": \"user\",\n \"coinSpecific\": {}\n },\n \"backupKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"prv\": \"xprv9s21ZrQH143K47iEnAFZRJz36E5ZxuEDBJETFYxJTsTVxuPc9z7oGWADUK6icX5P3ruoe244yxMt9uZ2LjWhddvnJJ4zB7zK93qBtxYrmN6\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"source\": \"backup\",\n \"ethAddress\": \"0xf5b7cca8621691f9dde304cb7128b6bb3d409363\",\n \"coinSpecific\": {}\n },\n \"bitgoKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"isBitGo\": true,\n \"source\": \"bitgo\",\n \"ethAddress\": \"0xa487900d0de75107b1cc7ade0e2662980e5ce940\",\n \"coinSpecific\": {}\n },\n \"warning\": \"Be sure to backup the backup keychain -- it is not stored anywhere else!\"\n}" } ] } ] }, { "name": "MPC", "item": [ { "name": "Generate wallet", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"label\": \"My Wallet\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"multisigType\": \"onchain\",\n \"type\": \"custodial\",\n \"passphrase\": \"string\",\n \"userKey\": \"string\",\n \"backupXpub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"backupXpubProvider\": \"dai\",\n \"disableTransactionNotifications\": true,\n \"passcodeEncryptionCode\": \"string\",\n \"coldDerivationSeed\": \"string\",\n \"gasPrice\": 1888,\n \"disableKRSEmail\": false,\n \"walletVersion\": 1,\n \"isDistributedCustody\": false,\n \"bitgoKeyId\": \"59cd72485007a239fb00282ed480da1f\",\n \"commonKeychain\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/generate?includeKeychains=false", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "generate" ], "query": [ { "key": "includeKeychains", "value": "false" } ], "variable": [ { "key": "coin", "value": "btc" } ] }, "description": "Generate a new wallet for a coin. If you want a wallet to hold tokens, generate a wallet for the native coin of the blockchain (e.g. generate an ETH wallet to hold ERC20 tokens).\n\nCalling this endpoint does all of the following:\n\n* Creates the user keychain locally on your machine and encrypts it with the provided passphrase (skipped if you pass a `userKey`).\n* Creates the backup keychain locally on your machine.\n* Uploads the encrypted user keychain and public backup keychain to BitGo.\n* Creates the BitGo key (and the backup key if you pass `backupXpubProvider`) on the service.\n* Creates the wallet on BitGo with the 3 public keys above.\n\nⓘ Many account-based assets, including Ethereum, require you to [Fund Gas Tanks](https://developers.bitgo.com/docs/get-started-gas-tanks) to initialize new wallets on chain. Ensure your gas tank has a sufficient balance to cover this cost before generating a new wallet.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"label\": \"My Wallet\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"multisigType\": \"onchain\",\n \"type\": \"custodial\",\n \"passphrase\": \"string\",\n \"userKey\": \"string\",\n \"backupXpub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"backupXpubProvider\": \"dai\",\n \"disableTransactionNotifications\": true,\n \"passcodeEncryptionCode\": \"string\",\n \"coldDerivationSeed\": \"string\",\n \"gasPrice\": 1888,\n \"disableKRSEmail\": false,\n \"walletVersion\": 1,\n \"isDistributedCustody\": false,\n \"bitgoKeyId\": \"59cd72485007a239fb00282ed480da1f\",\n \"commonKeychain\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/generate?includeKeychains=false", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", "generate" ], "query": [ { "key": "includeKeychains", "value": "false" } ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"wallet\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"users\": [\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"string\"\n ]\n }\n ],\n \"coin\": \"tbtc4\",\n \"label\": \"My TBTC4 Wallet\",\n \"m\": 2,\n \"n\": 3,\n \"keys\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"keySignatures\": {\n \"backupPub\": \"1fe81d0c91457d89993b01475bfb9e5809067ae046926faeab6e63beea009d8dd460387e0c3843034570798a9c2bcc1dbbea2988ee5a36979e0bbe6e02f7840af2\",\n \"bitgoPub\": \"209d0e9a6d4352b66fae0a35ce62c1059bcc4db9e2883abc4f1b3d20481c5cebb7299c581efd9e0151abaf2496da7c6d75d276de36ed3de37c94e9cc5a2ea77e59\"\n },\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"receiveAddress\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 5539,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1989-05-20T09:17:59.035Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 9517,\n \"totalSent\": 3160,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n },\n \"balance\": 0,\n \"balanceString\": \"0\",\n \"confirmedBalance\": 0,\n \"confirmedBalanceString\": \"0\",\n \"spendableBalance\": 0,\n \"spendableBalanceString\": \"0\",\n \"deleted\": false,\n \"isCold\": false,\n \"freeze\": {},\n \"disableTransactionNotifications\": false,\n \"admin\": {},\n \"approvalsRequired\": 1,\n \"allowBackupKeySigning\": false,\n \"coinSpecific\": {},\n \"clientFlags\": [\n \"string\"\n ],\n \"recoverable\": true,\n \"startDate\": \"2020-12-15T15:42:00.548Z\",\n \"hasLargeNumberOfAddresses\": false,\n \"config\": {}\n },\n \"encryptedWalletPassphrase\": \"\\\"{\\\\\\\"iv\\\\\\\":\\\\\\\"IpwAFi0+TDsLJCV4pg8T6w==\\\\\\\",\\\\\\\"v\\\\\\\":1,\\\\\\\"iter\\\\\\\":10000,\\\\\\\"ks\\\\\\\":256,\\\\\\\"ts\\\\\\\":64,\\\\\\\"mode\\\\\\\":\\\\\\\"ccm\\\\\\\",\\\\\\\"adata\\\\\\\":\\\\\\\"\\\\\\\",\\\\\\\"cipher\\\\\\\":\\\\\\\"aes\\\\\\\",\\\\\\\"salt\\\\\\\":\\\\\\\"3lkIc47rjzo=\\\\\\\",\\\\\\\"ct\\\\\\\":\\\\\\\"/m6JL/ttTJWXNmHm+dzI\\\\\\\"}\\\"\",\n \"userKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"encryptedPrv\": \"{\\\"iv\\\":\\\"TEd5eouui6hKashuVi5WHQ==\\\",\\\"v\\\":1,\\\"iter\\\":10000,\\\"ks\\\":256,\\\"ts\\\":64,\\\"mode\\\":\\\"ccm\\\",\\\"adata\\\":\\\"\\\",\\\"cipher\\\":\\\"aes\\\",\\\"salt\\\":\\\"dHu4PWoX2M8=\\\",\\\"ct\\\":\\\"fYr9Y/6kU40AosONkV0xi+fWsyhpYSew0L2YKH/qEZjOlxeDjpC2aTJ0Yc/KdmXheUGolcAxGSx93ykN21Zim1DGc/UGa25IUA/3ARgX7gBsYnYEy5e5Ol0YZYb9pa7KFeaDZSLMXrxxoahg5zL4AJsUx90Pwcg=\\\"}\",\n \"prv\": \"xprv9s21ZrQH143K3e1981rUcbKjJ9G57SDCDZ9HY4Sqhx5ZqMoyK1j49kAf1vuM1G9nhRr6kzqbUQb3gj5zuzrsvNRQ84tYf32EcyapRgBNpp4\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"ethAddress\": \"0xf5b7cca8621691f9dde304cb7128b6bb3d409363\",\n \"source\": \"user\",\n \"coinSpecific\": {}\n },\n \"backupKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"prv\": \"xprv9s21ZrQH143K47iEnAFZRJz36E5ZxuEDBJETFYxJTsTVxuPc9z7oGWADUK6icX5P3ruoe244yxMt9uZ2LjWhddvnJJ4zB7zK93qBtxYrmN6\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"source\": \"backup\",\n \"ethAddress\": \"0xf5b7cca8621691f9dde304cb7128b6bb3d409363\",\n \"coinSpecific\": {}\n },\n \"bitgoKeychain\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"pub\": \"xpub661MyMwAqRbcGMVhmc7wqQRYMtcX9LAvSj1pjB213y5TsrkV2uuzJjWnjBrT1FUeNWGPjaVm5p7o6jdNcQJrV1cy3a1R8NQ9m7LuYKA8RpH\",\n \"isBitGo\": true,\n \"source\": \"bitgo\",\n \"ethAddress\": \"0xa487900d0de75107b1cc7ade0e2662980e5ce940\",\n \"coinSpecific\": {}\n },\n \"warning\": \"Be sure to backup the backup keychain -- it is not stored anywhere else!\"\n}" } ] } ] } ] }, { "name": "Withdrawal Flow", "item": [ { "name": "Multisig Hot Simple", "item": [ { "name": "Send transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\",\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 327,\n \"feeRate\": 10000,\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": \"96\",\n \"minConfirms\": 7913,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 123,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 99815686819,\n \"maxFeePerGas\": \"2000000\"\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 6961,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 4388,\n \"ledgerSequenceDelta\": 8956,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 32,\n \"validToBlock\": 4903,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": \"2000000\",\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2006-11-18T12:51:20.493Z\"\n },\n \"data\": \"string\",\n \"hop\": true,\n \"tokenName\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/sendcoins", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "sendcoins" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "This call allows you to create and send cryptocurrency to a destination address." }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\",\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 327,\n \"feeRate\": 10000,\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": \"96\",\n \"minConfirms\": 7913,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 123,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 99815686819,\n \"maxFeePerGas\": \"2000000\"\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 6961,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 4388,\n \"ledgerSequenceDelta\": 8956,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 32,\n \"validToBlock\": 4903,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": \"2000000\",\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2006-11-18T12:51:20.493Z\"\n },\n \"data\": \"string\",\n \"hop\": true,\n \"tokenName\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/sendcoins", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "sendcoins" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1967-05-05T11:22:42.204Z\",\n \"info\": {\n \"transactionRequestFull\": {\n \"txRequestId\": \"string\",\n \"policyUniqueId\": \"59cd72485007a239fb00282ed480da1f\",\n \"verificationItems\": [\n \"string\"\n ],\n \"verificationRuleId\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"walletRebalanceEventId\": \"59cd72485007a239fb00282ed480da1f\",\n \"txRequest\": {\n \"txRequestId\": \"string\",\n \"version\": 6918.748869666562,\n \"latest\": true,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1955-07-06T22:07:34.509Z\",\n \"createdDate\": \"2024-09-29T02:56:52.196Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"selfSend\": true,\n \"intentType\": \"delegate\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": true,\n \"key_1\": 6181\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": 878.6515362192482,\n \"feeOptions\": {\n \"gasLimit\": 9500.210772588838,\n \"maxFeePerGas\": 6354.904469040721,\n \"maxPriorityFeePerGas\": 7350.489763504802\n },\n \"hopParams\": {\n \"gasPriceMax\": 3258.0717512945603,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 3445.358291797758\n }\n ],\n \"walletType\": \"custodial\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"validatorAddress\": \"string\",\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"intentType\": \"unstake\",\n \"stakingRequestId\": \"string\",\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": 4210.186015664796\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": true,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 2355.083999737857,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": true,\n \"value\": 9324.324970791233,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": true,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 1991.3652546282945,\n \"derivationIndex\": 9281.894852972193,\n \"address\": \"string\",\n \"chain\": 8297.70884398829,\n \"index\": 4170.201840099652\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n }\n },\n \"type\": \"transactionRequestFull\"\n },\n \"state\": \"pendingVideoApproval\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Accepted", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\",\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 327,\n \"feeRate\": 10000,\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": \"96\",\n \"minConfirms\": 7913,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 123,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 99815686819,\n \"maxFeePerGas\": \"2000000\"\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 6961,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 4388,\n \"ledgerSequenceDelta\": 8956,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 32,\n \"validToBlock\": 4903,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": \"2000000\",\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2006-11-18T12:51:20.493Z\"\n },\n \"data\": \"string\",\n \"hop\": true,\n \"tokenName\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/sendcoins", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "sendcoins" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1967-05-05T11:22:42.204Z\",\n \"info\": {\n \"transactionRequestFull\": {\n \"txRequestId\": \"string\",\n \"policyUniqueId\": \"59cd72485007a239fb00282ed480da1f\",\n \"verificationItems\": [\n \"string\"\n ],\n \"verificationRuleId\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"walletRebalanceEventId\": \"59cd72485007a239fb00282ed480da1f\",\n \"txRequest\": {\n \"txRequestId\": \"string\",\n \"version\": 6918.748869666562,\n \"latest\": true,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1955-07-06T22:07:34.509Z\",\n \"createdDate\": \"2024-09-29T02:56:52.196Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"selfSend\": true,\n \"intentType\": \"delegate\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": true,\n \"key_1\": 6181\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": 878.6515362192482,\n \"feeOptions\": {\n \"gasLimit\": 9500.210772588838,\n \"maxFeePerGas\": 6354.904469040721,\n \"maxPriorityFeePerGas\": 7350.489763504802\n },\n \"hopParams\": {\n \"gasPriceMax\": 3258.0717512945603,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 3445.358291797758\n }\n ],\n \"walletType\": \"custodial\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"validatorAddress\": \"string\",\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"intentType\": \"unstake\",\n \"stakingRequestId\": \"string\",\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": 4210.186015664796\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": true,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 2355.083999737857,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": true,\n \"value\": 9324.324970791233,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": true,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 1991.3652546282945,\n \"derivationIndex\": 9281.894852972193,\n \"address\": \"string\",\n \"chain\": 8297.70884398829,\n \"index\": 4170.201840099652\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n }\n },\n \"type\": \"transactionRequestFull\"\n },\n \"state\": \"pendingVideoApproval\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"approved\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"amount\": \"2000000\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\",\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 327,\n \"feeRate\": 10000,\n \"maxFeeRate\": 20000,\n \"feeMultiplier\": \"96\",\n \"minConfirms\": 7913,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 123,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 99815686819,\n \"maxFeePerGas\": \"2000000\"\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 6961,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 4388,\n \"ledgerSequenceDelta\": 8956,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 32,\n \"validToBlock\": 4903,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": \"2000000\",\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2006-11-18T12:51:20.493Z\"\n },\n \"data\": \"string\",\n \"hop\": true,\n \"tokenName\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/sendcoins", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "sendcoins" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] } ] }, { "name": "Multisig Hot Manual", "item": [ { "name": "Build a transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ],\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 585,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"-931\",\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 7046,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 8463,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": \"2000000\",\n \"maxFeePerGas\": 6348\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 5741,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 1826,\n \"ledgerSequenceDelta\": 3076,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 8925,\n \"validToBlock\": 2184,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": 1892,\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2021-10-28T16:58:52.378Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/build?destinationTag=string", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "build" ], "query": [ { "key": "destinationTag", "value": "string", "description": "Required when sending to a BitGo wallet.\n" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Build a transaction from the wallet using provided options. Use only with multisignature wallets. For MPC wallets, use [Create transaction request](/reference/v2wallettxrequestcreate). If you want to build, sign, and send all in one call, use [Send transaction](/reference/expresswalletsendcoins).\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ],\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 585,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"-931\",\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 7046,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 8463,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": \"2000000\",\n \"maxFeePerGas\": 6348\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 5741,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 1826,\n \"ledgerSequenceDelta\": 3076,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 8925,\n \"validToBlock\": 2184,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": 1892,\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2021-10-28T16:58:52.378Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/build?destinationTag=string", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "build" ], "query": [ { "description": "Required when sending to a BitGo wallet.\n", "key": "destinationTag", "value": "string" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"keyDerivationPath\": \"string\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"recipients\": [\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": \"string\"\n },\n {\n \"amount\": \"2000000\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ],\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 585,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"-931\",\n \"feeMultiplier\": 1.5,\n \"minConfirms\": 7046,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": 8463,\n \"eip1559\": {\n \"maxPriorityFeePerGas\": \"2000000\",\n \"maxFeePerGas\": 6348\n },\n \"gasLimit\": \"2000000\",\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": 5741,\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": false,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 1826,\n \"ledgerSequenceDelta\": 3076,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": false,\n \"validFromBlock\": 8925,\n \"validToBlock\": 2184,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"amount\": 1892,\n \"validator\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2021-10-28T16:58:52.378Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/build?destinationTag=string", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "build" ], "query": [ { "description": "Required when sending to a BitGo wallet.\n", "key": "destinationTag", "value": "string" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Sign transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"prv\": \"xprv9s21ZrQH143K3xQwj4yx3fHjDieEdqFDweBvFxn28qGvfQGvweUWuUuDRpepDu6opq3jiWHU9h3yYTKk5vvu4ykRuGA4i4Kz1vmFMPLTsoC\",\n \"txPrebuild\": {\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"txHex\": \"string\",\n \"txBase64\": \"string\",\n \"txInfo\": {\n \"changeAddresses\": [\n \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n ],\n \"nOutputs\": 2,\n \"nP2SHInputs\": 0,\n \"nSegwitInputs\": 1,\n \"unspents\": [\n {\n \"id\": \"003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2\",\n \"address\": \"2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2\",\n \"value\": 624,\n \"valueString\": \"2000000\",\n \"blockHeight\": 8676,\n \"date\": \"2017-03-25T23:01:40.248Z\",\n \"coinbase\": true,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"fromWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"chain\": 0,\n \"index\": 6464,\n \"redeemScript\": \"522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae\",\n \"witnessScript\": \"52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae\",\n \"isSegwit\": true\n },\n {\n \"id\": \"003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2\",\n \"address\": \"2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2\",\n \"value\": 9515,\n \"valueString\": \"2000000\",\n \"blockHeight\": 1272,\n \"date\": \"2017-03-25T23:01:40.248Z\",\n \"coinbase\": true,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"fromWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"chain\": 0,\n \"index\": 6117,\n \"redeemScript\": \"522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae\",\n \"witnessScript\": \"52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae\",\n \"isSegwit\": true\n }\n ],\n \"walletAddressDetails\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 4509,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1999-08-18T11:13:15.763Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 5225,\n \"totalSent\": 2738,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n }\n },\n \"feeInfo\": {\n \"size\": 776,\n \"fee\": 38800,\n \"feeRate\": \"string\",\n \"payGoFee\": 0,\n \"payGoFeeString\": 1841\n }\n },\n \"isLastSignature\": true,\n \"pubs\": [\n \"string\",\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/signtx", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "signtx" ], "variable": [ { "key": "coin", "value": "btc" } ] }, "description": "This route is for users who would like to maintain their own keys, or otherwise would not like BitGo to decrypt their key, and instead provide it in the clear themselves" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"prv\": \"xprv9s21ZrQH143K3xQwj4yx3fHjDieEdqFDweBvFxn28qGvfQGvweUWuUuDRpepDu6opq3jiWHU9h3yYTKk5vvu4ykRuGA4i4Kz1vmFMPLTsoC\",\n \"txPrebuild\": {\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"txHex\": \"string\",\n \"txBase64\": \"string\",\n \"txInfo\": {\n \"changeAddresses\": [\n \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\"\n ],\n \"nOutputs\": 2,\n \"nP2SHInputs\": 0,\n \"nSegwitInputs\": 1,\n \"unspents\": [\n {\n \"id\": \"003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2\",\n \"address\": \"2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2\",\n \"value\": 624,\n \"valueString\": \"2000000\",\n \"blockHeight\": 8676,\n \"date\": \"2017-03-25T23:01:40.248Z\",\n \"coinbase\": true,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"fromWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"chain\": 0,\n \"index\": 6464,\n \"redeemScript\": \"522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae\",\n \"witnessScript\": \"52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae\",\n \"isSegwit\": true\n },\n {\n \"id\": \"003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2\",\n \"address\": \"2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2\",\n \"value\": 9515,\n \"valueString\": \"2000000\",\n \"blockHeight\": 1272,\n \"date\": \"2017-03-25T23:01:40.248Z\",\n \"coinbase\": true,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"fromWallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"chain\": 0,\n \"index\": 6117,\n \"redeemScript\": \"522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae\",\n \"witnessScript\": \"52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae\",\n \"isSegwit\": true\n }\n ],\n \"walletAddressDetails\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 4509,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1999-08-18T11:13:15.763Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 5225,\n \"totalSent\": 2738,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n }\n },\n \"feeInfo\": {\n \"size\": 776,\n \"fee\": 38800,\n \"feeRate\": \"string\",\n \"payGoFee\": 0,\n \"payGoFeeString\": 1841\n }\n },\n \"isLastSignature\": true,\n \"pubs\": [\n \"string\",\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/signtx", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "signtx" ], "variable": [ { "key": "coin", "value": "btc" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txInfo\": {\n \"halfSigned\": {\n \"txBase64\": \"AAAAAGRnXg19FteG/7zPd+jDC7LDvRlzgfFC+JrPhRep0kYiAAAAZAB/4cUAAAACAAAAAAAAAAAAAAABAAAAAQAAAABkZ14NfRbXhv+8z3fowwuyw70Zc4HxQviaz4UXqdJGIgAAAAEAAAAAmljT/+FedddnAHwo95dOC4RNy6eVLSehaJY34b9GxuYAAAAAAAAAAAehIAAAAAAAAAAAAUrgwAkAAABAOExcvVJIUJv9HuVfbV0y7lRPRARv4wDtcdhHG7QN40h5wQ2uwPF52OGQ8KY+66a1A/8lNKB75sgj2xj44s8lDQ==\"\n }\n }\n}" } ] }, { "name": "Send a half-signed transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Send a half-signed transaction to BitGo for final signing (using the BitGo key) and broadcasting.\n" }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"transfer\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"txid\": \"b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26\",\n \"height\": 5127,\n \"date\": \"1974-04-04T11:00:58.742Z\",\n \"confirmations\": 934,\n \"type\": \"receive\",\n \"valueString\": \"2000000\",\n \"usd\": 9704.460165178576,\n \"usdRate\": 2341.9817682783296,\n \"state\": \"confirmed\",\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"history\": [\n {\n \"date\": \"1996-05-25T15:15:26.755Z\",\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"action\": \"signed\",\n \"comment\": \"string\"\n },\n {\n \"date\": \"1993-11-27T15:53:26.831Z\",\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"action\": \"commented\",\n \"comment\": \"string\"\n }\n ],\n \"comment\": \"string\",\n \"coinSpecific\": {},\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"txidType\": \"blockHash\",\n \"heightId\": \"string\",\n \"value\": 5125,\n \"intendedValueString\": \"2000000\",\n \"baseValue\": 9328,\n \"baseValueString\": \"2000000\",\n \"baseValueWithoutFees\": 6188,\n \"baseValueWithoutFeesString\": \"2000000\",\n \"feeString\": \"string\",\n \"payGoFee\": 4304,\n \"payGoFeeString\": \"string\",\n \"vSize\": 6614,\n \"sequenceId\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"txRequestId\": \"string\",\n \"goStakingRequestId\": \"string\",\n \"subType\": \"ofc_withdrawal\",\n \"feeCoin\": \"string\",\n \"instant\": true,\n \"instantId\": \"string\",\n \"isFee\": true,\n \"isReward\": true,\n \"isUnlock\": true,\n \"metadata\": [\n {\n \"key\": \"string\",\n \"value\": \"string\"\n },\n {\n \"key\": \"string\",\n \"value\": \"string\"\n }\n ],\n \"sendAccounting\": [\n {\n \"type\": \"string\",\n \"amountString\": \"string\",\n \"nOuts\": 7913,\n \"amount\": 8642,\n \"id\": \"string\"\n },\n {\n \"type\": \"string\",\n \"amountString\": \"string\",\n \"nOuts\": 7393,\n \"amount\": 7521,\n \"id\": \"string\"\n }\n ],\n \"createdTime\": \"1987-04-29T19:45:11.614Z\",\n \"approvedTime\": \"2015-09-04T08:47:21.644Z\",\n \"rejectedTime\": \"2015-01-15T14:30:48.981Z\",\n \"signedTime\": \"1964-07-01T14:16:39.183Z\",\n \"unconfirmedTime\": \"2023-04-03T20:37:53.290Z\",\n \"confirmedTime\": \"2014-04-12T07:29:27.159Z\",\n \"removedTime\": \"1970-01-19T01:25:07.260Z\",\n \"commentedTime\": \"2017-06-14T10:44:02.873Z\",\n \"failedTime\": \"2012-02-09T19:51:52.385Z\",\n \"regeneratedTime\": \"2017-11-02T10:34:29.306Z\",\n \"replacedTime\": \"1971-08-08T23:37:11.498Z\",\n \"replacingTime\": \"1988-05-03T09:31:39.351Z\",\n \"abandonedTime\": \"1957-03-31T17:50:03.204Z\",\n \"signedDate\": \"1969-01-12T04:14:25.473Z\",\n \"customerApprovedTime\": \"2021-11-09T04:39:48.878Z\",\n \"idVerificationTime\": \"1947-06-01T15:56:28.137Z\",\n \"trustSignedTime\": \"1985-04-11T17:15:50.227Z\",\n \"trustFinalApprovalTime\": \"1976-08-26T23:02:59.123Z\",\n \"walletLabel\": \"string\",\n \"enterpriseName\": \"string\",\n \"elliptic\": \"string\",\n \"senderInformationVerified\": false,\n \"buildParams\": {\n \"key_0\": 1115\n },\n \"entries\": [\n {\n \"address\": \"2NAUwNgXaoFj2VVnSEvNLGuez8CfdU2UCMZ\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"value\": 1438,\n \"valueString\": \"2000000\",\n \"isChange\": true,\n \"isPayGo\": true,\n \"token\": \"omg\",\n \"label\": \"string\",\n \"failed\": true,\n \"associatedNativeCoinAddress\": \"string\",\n \"memo\": \"string\",\n \"type\": \"string\",\n \"nftId\": \"string\",\n \"nftSymbol\": \"string\"\n },\n {\n \"address\": \"2NAUwNgXaoFj2VVnSEvNLGuez8CfdU2UCMZ\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"value\": 8254,\n \"valueString\": \"2000000\",\n \"isChange\": false,\n \"isPayGo\": false,\n \"token\": \"omg\",\n \"label\": \"string\",\n \"failed\": false,\n \"associatedNativeCoinAddress\": \"string\",\n \"memo\": \"string\",\n \"type\": \"string\",\n \"nftId\": \"string\",\n \"nftSymbol\": \"string\"\n }\n ],\n \"usersNotified\": true,\n \"label\": \"string\",\n \"replaces\": [\n \"string\",\n \"string\"\n ],\n \"replacedBy\": [\n \"string\",\n \"string\"\n ],\n \"riskIndicators\": [\n \"SELFDESTRUCT\",\n \"SELFDESTRUCT\"\n ]\n },\n \"txid\": \"string\",\n \"tx\": \"string\",\n \"status\": \"confirmed\"\n}" }, { "name": "Accepted", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1989-05-31T09:35:58.829Z\",\n \"info\": {\n \"policyRuleRequest\": {\n \"action\": \"string\",\n \"updateEnterpriseRequest\": {\n \"type\": \"updateEnterpriseRequest\",\n \"action\": \"remove\",\n \"permission\": \"admin\",\n \"userId\": \"string\",\n \"email\": \"user@example.com\"\n }\n },\n \"type\": \"policyRuleRequest\"\n },\n \"state\": \"approved\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"pendingVideoApproval\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Locked", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"messages\": [\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n },\n {\n \"address\": \"string\",\n \"message\": \"BIP322 test message.\"\n }\n ],\n \"numBlocks\": 829,\n \"feeRate\": 10000,\n \"maxFeeRate\": \"28005844\",\n \"feeMultiplier\": \"-5876..1170.\",\n \"minConfirms\": 9792,\n \"enforceMinConfirmsForChange\": false,\n \"gasPrice\": \"2000000\",\n \"eip1559\": {\n \"maxPriorityFeePerGas\": 25359045180,\n \"maxFeePerGas\": 8219\n },\n \"gasLimit\": 8274,\n \"targetWalletUnspents\": 1000,\n \"minValue\": \"2000000\",\n \"maxValue\": \"2000000\",\n \"sequenceId\": \"string\",\n \"nonce\": \"2000000\",\n \"noSplitChange\": false,\n \"unspents\": [\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\",\n \"12b147dd8b4f73c01f72bdbf5b589eea614f3de609ffdbdac84852d6505cf8a3:1\"\n ],\n \"changeAddress\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"txFormat\": \"psbt\",\n \"instant\": true,\n \"memo\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"comment\": \"string\",\n \"destinationChain\": \"string\",\n \"sourceChain\": \"string\",\n \"addressType\": \"string\",\n \"changeAddressType\": [\n \"p2sh\",\n \"p2sh\"\n ],\n \"startTime\": \"string\",\n \"consolidateId\": \"59cd72485007a239fb00282ed480da1f\",\n \"lastLedgerSequence\": 8927,\n \"ledgerSequenceDelta\": 7566,\n \"rbfTxIds\": [\n \"string\",\n \"string\"\n ],\n \"isReplaceableByFee\": true,\n \"validFromBlock\": 3590,\n \"validToBlock\": 1303,\n \"trustlines\": [\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"remove\",\n \"limit\": \"2000000\"\n },\n {\n \"token\": \"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L\",\n \"action\": \"add\",\n \"limit\": \"2000000\"\n }\n ],\n \"stakingOptions\": {\n \"contractName\": \"pox-3\",\n \"functionName\": \"delegate-stx\",\n \"functionArgs\": [\n {\n \"type\": \"optional\",\n \"val\": \"string\"\n },\n {\n \"type\": \"principal\",\n \"val\": \"string\"\n }\n ]\n },\n \"messageKey\": \"string\",\n \"reservation\": {\n \"expireTime\": \"2014-06-05T08:57:55.257Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "tx", "send" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Locked (WebDAV) (RFC 4918)", "code": 423, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\"\n}" } ] } ] }, { "name": "MPC Hot Simple", "item": [ { "name": "Create a signature share for the transaction request", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Allows users to supply their signature share for signing. Use only with MPC wallets." }, "response": [ { "name": "Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Unauthorized", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Forbidden", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Not Found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"signatureShare\": {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n },\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"signerShare\": \"string\",\n \"userPublicGpgKey\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests/:id/signatureshares", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests", ":id", "signatureshares" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." }, { "key": "id", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Get transaction requests by wallet", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests?txRequestIds=string&txRequestIds=string&idempotencyKeys=string&idempotencyKeys=string&sequenceIds=string&sequenceIds=string&intentTypes=vote&intentTypes=stake&excludeIntentTypes=vote&excludeIntentTypes=authorize&states=readyToSend&states=canceled&latest=true&limit=25&prevId=59cd72485007a239fb00282ed480da1f&version=string&sortBy=createdDate&sortDirection=DESC&dateLt=1955-03-29T11:27:49.387Z&dateGte=1955-03-29T11:27:49.387Z&includeEvmKeyringTxRequests=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "query": [ { "key": "txRequestIds", "value": "string", "description": "If provided, only the specified transaction requests will be returned." }, { "key": "txRequestIds", "value": "string", "description": "If provided, only the specified transaction requests will be returned." }, { "key": "idempotencyKeys", "value": "string", "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned." }, { "key": "idempotencyKeys", "value": "string", "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned." }, { "key": "sequenceIds", "value": "string", "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly." }, { "key": "sequenceIds", "value": "string", "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly." }, { "key": "intentTypes", "value": "vote", "description": "If provided, only transaction requests with the specified intent types will be returned." }, { "key": "intentTypes", "value": "stake", "description": "If provided, only transaction requests with the specified intent types will be returned." }, { "key": "excludeIntentTypes", "value": "vote", "description": "If provided, transaction requests with the specified intent types will be excluded." }, { "key": "excludeIntentTypes", "value": "authorize", "description": "If provided, transaction requests with the specified intent types will be excluded." }, { "key": "states", "value": "readyToSend", "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document." }, { "key": "states", "value": "canceled", "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document." }, { "key": "latest", "value": "true", "description": "If provided, only the latest transaction request version will be returned." }, { "key": "limit", "value": "25", "description": "Maximum number of results to return. If the result set is truncated, use the \"nextBatchPrevId\" value to get the next batch." }, { "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f", "description": "Return the next batch of results, based on the \"nextBatchPrevId\" value from the previous batch." }, { "key": "version", "value": "string" }, { "key": "sortBy", "value": "createdDate", "description": "Sorts by specified field, default sorting by id." }, { "key": "sortDirection", "value": "DESC", "description": "Sorts order by field in specified sort direction, default ascending." }, { "key": "dateLt", "value": "1955-03-29T11:27:49.387Z", "description": "Optional get transaction requests less than date" }, { "key": "dateGte", "value": "1955-03-29T11:27:49.387Z", "description": "Optional get transaction requests greater than or equal to date" }, { "key": "includeEvmKeyringTxRequests", "value": "true", "description": "If true, include transaction requests for all EVM keyring related wallets (main + derived)." } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Get a paginated list of transaction requests filtered by wallet. Use only with MPC wallets." }, "response": [ { "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests?txRequestIds=string&idempotencyKeys=string&sequenceIds=string&intentTypes=stake&excludeIntentTypes=authorize&states=canceled&latest=true&limit=25&prevId=59cd72485007a239fb00282ed480da1f&version=string&sortBy=createdDate&sortDirection=DESC&dateLt=1955-03-29T11:27:49.387Z&dateGte=1955-03-29T11:27:49.387Z&includeEvmKeyringTxRequests=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "query": [ { "description": "If provided, only the specified transaction requests will be returned.", "key": "txRequestIds", "value": "string" }, { "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned.", "key": "idempotencyKeys", "value": "string" }, { "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly.", "key": "sequenceIds", "value": "string" }, { "description": "If provided, only transaction requests with the specified intent types will be returned.", "key": "intentTypes", "value": "stake" }, { "description": "If provided, transaction requests with the specified intent types will be excluded.", "key": "excludeIntentTypes", "value": "authorize" }, { "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document.", "key": "states", "value": "canceled" }, { "description": "If provided, only the latest transaction request version will be returned.", "key": "latest", "value": "true" }, { "description": "Maximum number of results to return. If the result set is truncated, use the \"nextBatchPrevId\" value to get the next batch.", "key": "limit", "value": "25" }, { "description": "Return the next batch of results, based on the \"nextBatchPrevId\" value from the previous batch.", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "key": "version", "value": "string" }, { "description": "Sorts by specified field, default sorting by id.", "key": "sortBy", "value": "createdDate" }, { "description": "Sorts order by field in specified sort direction, default ascending.", "key": "sortDirection", "value": "DESC" }, { "description": "Optional get transaction requests less than date", "key": "dateLt", "value": "1955-03-29T11:27:49.387Z" }, { "description": "Optional get transaction requests greater than or equal to date", "key": "dateGte", "value": "1955-03-29T11:27:49.387Z" }, { "description": "If true, include transaction requests for all EVM keyring related wallets (main + derived).", "key": "includeEvmKeyringTxRequests", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequests\": [\n {\n \"txRequestId\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"walletId\": \"59cd72485007a239fb00282ed480da1f\",\n \"version\": 9285.260540694975,\n \"state\": \"pendingUserGShare\",\n \"date\": \"2021-01-01T00:00:00.000Z\",\n \"createdDate\": \"2021-01-01T00:00:00.000Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n \"\"\n ],\n \"latest\": false,\n \"intent\": {\n \"validatorAddress\": \"string\",\n \"requestNumber\": 3086.7632390611234,\n \"intentType\": \"switchValidator\",\n \"stakingRequestId\": \"string\",\n \"amount\": {\n \"symbol\": \"string\",\n \"value\": \"string\"\n },\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n },\n \"unsignedTxs\": [\n {\n \"parsedTx\": {\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"_id\": \"string\",\n \"address\": \"string\",\n \"chain\": 1391.0265925246756,\n \"derivationIndex\": 2345.8880575952603,\n \"index\": 8639.532314039656,\n \"value\": 7241.498296807454\n }\n ],\n \"minerFee\": 3320.6489077600486,\n \"outputs\": [\n {\n \"valueString\": \"string\",\n \"address\": \"string\",\n \"change\": true,\n \"coinName\": \"string\",\n \"data\": \"string\",\n \"isPayGo\": true,\n \"value\": 8275.400575685344,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\"\n }\n ],\n \"spendAmount\": 4902.887255460435,\n \"gasPrice\": 9023.708800840164,\n \"hasUnvalidatedData\": false,\n \"payGoFee\": \"string\",\n \"spendAmounts\": [\n {\n \"key_0\": 5504.458893319175,\n \"key_1\": 5071.6968297837075\n }\n ],\n \"type\": \"string\"\n },\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"coinSpecific\": {\n \"nonceAddress\": \"string\",\n \"stakingAddress\": \"string\",\n \"signature\": \"string\",\n \"key_0\": \"string\"\n },\n \"feeInfo\": {\n \"fee\": \"string\",\n \"feeString\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"vssProof\": \"string\",\n \"privateShareProof\": \"string\",\n \"publicShare\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"type\": \"commitment\",\n \"from\": \"user\",\n \"to\": \"backup\",\n \"share\": \"string\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ],\n \"apiVersion\": \"lite\",\n \"idempotencyKey\": \"string\",\n \"walletType\": \"custodial\",\n \"enterpriseId\": \"59cd72485007a239fb00282ed480da1f\",\n \"pendingApprovalId\": \"string\",\n \"policiesChecked\": false,\n \"isCanceled\": false\n }\n ],\n \"nextBatchPrevId\": \"929f783f-3582-957b-7e74-9a3cff84d161\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests?txRequestIds=string&idempotencyKeys=string&sequenceIds=string&intentTypes=stake&excludeIntentTypes=authorize&states=canceled&latest=true&limit=25&prevId=59cd72485007a239fb00282ed480da1f&version=string&sortBy=createdDate&sortDirection=DESC&dateLt=1955-03-29T11:27:49.387Z&dateGte=1955-03-29T11:27:49.387Z&includeEvmKeyringTxRequests=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "query": [ { "description": "If provided, only the specified transaction requests will be returned.", "key": "txRequestIds", "value": "string" }, { "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned.", "key": "idempotencyKeys", "value": "string" }, { "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly.", "key": "sequenceIds", "value": "string" }, { "description": "If provided, only transaction requests with the specified intent types will be returned.", "key": "intentTypes", "value": "stake" }, { "description": "If provided, transaction requests with the specified intent types will be excluded.", "key": "excludeIntentTypes", "value": "authorize" }, { "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document.", "key": "states", "value": "canceled" }, { "description": "If provided, only the latest transaction request version will be returned.", "key": "latest", "value": "true" }, { "description": "Maximum number of results to return. If the result set is truncated, use the \"nextBatchPrevId\" value to get the next batch.", "key": "limit", "value": "25" }, { "description": "Return the next batch of results, based on the \"nextBatchPrevId\" value from the previous batch.", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "key": "version", "value": "string" }, { "description": "Sorts by specified field, default sorting by id.", "key": "sortBy", "value": "createdDate" }, { "description": "Sorts order by field in specified sort direction, default ascending.", "key": "sortDirection", "value": "DESC" }, { "description": "Optional get transaction requests less than date", "key": "dateLt", "value": "1955-03-29T11:27:49.387Z" }, { "description": "Optional get transaction requests greater than or equal to date", "key": "dateGte", "value": "1955-03-29T11:27:49.387Z" }, { "description": "If true, include transaction requests for all EVM keyring related wallets (main + derived).", "key": "includeEvmKeyringTxRequests", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" }, { "name": "Not Found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests?txRequestIds=string&idempotencyKeys=string&sequenceIds=string&intentTypes=stake&excludeIntentTypes=authorize&states=canceled&latest=true&limit=25&prevId=59cd72485007a239fb00282ed480da1f&version=string&sortBy=createdDate&sortDirection=DESC&dateLt=1955-03-29T11:27:49.387Z&dateGte=1955-03-29T11:27:49.387Z&includeEvmKeyringTxRequests=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "query": [ { "description": "If provided, only the specified transaction requests will be returned.", "key": "txRequestIds", "value": "string" }, { "description": "If provided, only transaction requests with the matching idempotencyKeys will be returned.", "key": "idempotencyKeys", "value": "string" }, { "description": "A \"sequenceId\" is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a \"sequenceId\" you can easily reference transfers and transactions—for example, to safely retry sending. Because the system only confirms one send request per \"sequenceId\" (and fails all subsequent attempts), you can retry sending without the risk of double spending. The \"sequenceId\" is only visible to users on the wallet and is not shared publicly.", "key": "sequenceIds", "value": "string" }, { "description": "If provided, only transaction requests with the specified intent types will be returned.", "key": "intentTypes", "value": "stake" }, { "description": "If provided, transaction requests with the specified intent types will be excluded.", "key": "excludeIntentTypes", "value": "authorize" }, { "description": "If provided, only transaction requests of the specified state will be returned.\n- `canceled`: Canceled by a wallet spender before approval or sending.\n- `delivered`: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion \"full\".\n- `failed` : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).\n- `initialized`: First state when a transaction request is created (before any policy evaluation occurs).\n- `pendingApproval`: Triggered a policy that requires approval to proceed.\n- `pendingDelivery`: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion \"full\".\n- `pendingUserCommitment`: Ready to receive your user commitments. This state is only used with apiVersion \"lite\" and EdDSA assets with commitment signing states.\n- `pendingUserGShare`: Ready to receive your gShare.\n- `pendingUserRShare`: Ready to receive your rShare.\n- `pendingUserSignature`: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion \"lite\" and EdDSA assets without commitment signing states.\n- `readyToSend`: Ready send (share combination is complete).\n- `rejected`: Rejected by an approver.\n- `signed`: All transactions in the transaction request were signed. All future updates will be in the transfer document.", "key": "states", "value": "canceled" }, { "description": "If provided, only the latest transaction request version will be returned.", "key": "latest", "value": "true" }, { "description": "Maximum number of results to return. If the result set is truncated, use the \"nextBatchPrevId\" value to get the next batch.", "key": "limit", "value": "25" }, { "description": "Return the next batch of results, based on the \"nextBatchPrevId\" value from the previous batch.", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "key": "version", "value": "string" }, { "description": "Sorts by specified field, default sorting by id.", "key": "sortBy", "value": "createdDate" }, { "description": "Sorts order by field in specified sort direction, default ascending.", "key": "sortDirection", "value": "DESC" }, { "description": "Optional get transaction requests less than date", "key": "dateLt", "value": "1955-03-29T11:27:49.387Z" }, { "description": "Optional get transaction requests greater than or equal to date", "key": "dateGte", "value": "1955-03-29T11:27:49.387Z" }, { "description": "If true, include transaction requests for all EVM keyring related wallets (main + derived).", "key": "includeEvmKeyringTxRequests", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" } ] } ] }, { "name": "MPC Hot Manual", "item": [ { "name": "Create transaction request", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Allows users to create a transaction request given they have spender permissions on the wallet. Use only with MPC wallets. For multisignature wallets, use [Build a transaction](/reference/v2wallettxbuild)." }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequestId\": \"string\",\n \"version\": 962.564638517922,\n \"latest\": false,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1958-06-05T10:04:39.057Z\",\n \"createdDate\": \"2024-05-29T09:49:46.292Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"intentType\": \"transferStake\",\n \"enableTokens\": [\n {\n \"name\": \"string\",\n \"address\": \"string\"\n }\n ],\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n }\n ],\n \"walletType\": \"advanced\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"selfSend\": true,\n \"intentType\": \"transferReject\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": 5570.607554665372\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"feeOptions\": {\n \"gasLimit\": 295.37930655326505,\n \"maxFeePerGas\": 2882.2355055659887,\n \"maxPriorityFeePerGas\": 8776.593048243323\n },\n \"hopParams\": {\n \"gasPriceMax\": 4342.861276232715,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 4877.688888752396\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": false,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 3677.794523097193,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": false,\n \"value\": 4657.505498904082,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": false,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 464.16276858725735,\n \"derivationIndex\": 7407.991523888358,\n \"address\": \"string\",\n \"chain\": 495.6934451736261,\n \"index\": 9603.794985209446\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n}" }, { "name": "Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequestId\": \"string\",\n \"version\": 962.564638517922,\n \"latest\": false,\n \"walletId\": \"string\",\n \"state\": \"pendingUserGShare\",\n \"date\": \"1958-06-05T10:04:39.057Z\",\n \"createdDate\": \"2024-05-29T09:49:46.292Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"intentType\": \"transferStake\",\n \"enableTokens\": [\n {\n \"name\": \"string\",\n \"address\": \"string\"\n }\n ],\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n }\n ],\n \"walletType\": \"advanced\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"selfSend\": true,\n \"intentType\": \"transferReject\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"option\": {\n \"key_0\": 5570.607554665372\n }\n },\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"data\": \"string\"\n }\n ],\n \"isTestTransaction\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"feeOptions\": {\n \"gasLimit\": 295.37930655326505,\n \"maxFeePerGas\": 2882.2355055659887,\n \"maxPriorityFeePerGas\": 8776.593048243323\n },\n \"hopParams\": {\n \"gasPriceMax\": 4342.861276232715,\n \"paymentId\": \"string\",\n \"userReqSig\": \"string\"\n },\n \"receiveAddress\": \"string\",\n \"senderAddressIndex\": 4877.688888752396\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": false,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 3677.794523097193,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": false,\n \"value\": 4657.505498904082,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": false,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 464.16276858725735,\n \"derivationIndex\": 7407.991523888358,\n \"address\": \"string\",\n \"chain\": 495.6934451736261,\n \"index\": 9603.794985209446\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Unauthorized", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Forbidden", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Not Found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"intent\": {\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"stakingProxy\": \"string\",\n \"intentType\": \"stakeClaimRewards\",\n \"stakingRequestId\": \"string\",\n \"stopStaking\": false,\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"fee\": {\n \"amount\": 4075.8267974737228,\n \"formula\": \"feeRate\",\n \"type\": \"tip\",\n \"unit\": \"ram\"\n }\n },\n \"idempotencyKey\": \"string\",\n \"videoApprovers\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"apiVersion\": \"full\",\n \"preview\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId/txrequests", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId", "txrequests" ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Sign MPC transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"txRequestId\": \"string\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/signtxtss", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "signtxtss" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Sign transactions for MPC wallets. If using external-signer mode, you must maintain your keys, in the clear, on a separate Express server - BitGo doesn't decrypt your private MPC key shares." }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"txRequestId\": \"string\",\n \"walletPassphrase\": \"string\",\n \"prv\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/signtxtss", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "signtxtss" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"txRequestId\": \"string\",\n \"version\": 1436.0992270026563,\n \"latest\": true,\n \"walletId\": \"string\",\n \"state\": \"rejected\",\n \"date\": \"2013-03-18T17:12:57.047Z\",\n \"createdDate\": \"1994-09-04T13:46:31.082Z\",\n \"userId\": \"string\",\n \"initiatedBy\": \"string\",\n \"updatedBy\": \"string\",\n \"intents\": [\n {\n \"intentType\": \"stake\",\n \"stakingRequestId\": \"string\",\n \"recipients\": [\n {\n \"address\": {\n \"address\": \"string\",\n \"options\": {}\n },\n \"amount\": {\n \"value\": \"100\",\n \"symbol\": \"usdc\"\n },\n \"data\": \"string\",\n \"tokenData\": {\n \"tokenType\": \"ERC721\",\n \"tokenQuantity\": \"101\",\n \"tokenContractAddress\": \"0x3d8e90d5F403a0A18dfeeAd36E30EF95D5E1ad3a\",\n \"tokenName\": \"tpolygon:name\",\n \"tokenId\": \"123\",\n \"decimalPlaces\": 18\n }\n }\n ],\n \"sequenceId\": \"abc123\",\n \"comment\": \"string\",\n \"nonce\": \"string\",\n \"memo\": \"string\"\n }\n ],\n \"walletType\": \"custodial\",\n \"enterpriseId\": \"string\",\n \"intent\": {\n \"validatorAddress\": \"string\",\n \"amount\": {\n \"value\": \"string\",\n \"symbol\": \"string\"\n },\n \"intentType\": \"enableToken\",\n \"stakingRequestId\": \"string\",\n \"memo\": \"string\",\n \"sequenceId\": \"string\",\n \"comment\": \"string\",\n \"nonce\": \"string\"\n },\n \"pendingApprovalId\": \"string\",\n \"isCanceled\": false,\n \"unsignedTxs\": [\n {\n \"serializedTxHex\": \"string\",\n \"signableHex\": \"string\",\n \"derivationPath\": \"string\",\n \"feeInfo\": {\n \"fee\": 3629.323506207951,\n \"feeString\": \"string\"\n },\n \"coinSpecific\": {},\n \"parsedTx\": {\n \"minerFee\": \"string\",\n \"outputs\": [\n {\n \"address\": \"string\",\n \"valueString\": \"string\",\n \"isPayGo\": false,\n \"value\": 556.0549624045664,\n \"wallet\": \"string\",\n \"walletV1\": \"string\",\n \"baseAddress\": \"string\",\n \"enterprise\": \"string\",\n \"data\": \"string\",\n \"change\": false,\n \"coinName\": \"string\"\n }\n ],\n \"inputs\": [\n {\n \"valueString\": \"string\",\n \"value\": 1269.126878824407,\n \"derivationIndex\": 3885.518842419855,\n \"address\": \"string\",\n \"chain\": 8127.4724701773175,\n \"index\": 6137.47357885591\n }\n ],\n \"spendAmount\": \"string\",\n \"spendAmounts\": [\n {\n \"coinName\": \"string\",\n \"amountString\": \"string\"\n }\n ],\n \"payGoFee\": \"string\",\n \"type\": \"string\",\n \"memo\": \"string\"\n }\n }\n ],\n \"signatureShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\"\n }\n ],\n \"commitmentShares\": [\n {\n \"from\": \"user\",\n \"to\": \"user\",\n \"share\": \"string\",\n \"type\": \"commitment\"\n }\n ],\n \"txHashes\": [\n \"string\"\n ]\n}" } ] } ] } ] } ] }, { "name": "Create Whitelists", "item": [ { "name": "Add wallet-policy rule", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"my-rule-id\",\n \"type\": \"advancedWhitelist\",\n \"condition\": {\n \"add\": {\n \"type\": \"my-wallet-id\",\n \"item\": \"my-item-id\",\n \"metaData\": {\n \"label\": \"Recipient Wallet\"\n }\n }\n },\n \"action\": {\n \"type\": \"getApproval\",\n \"userIds\": []\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/policy/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "policy", "rule" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] }, "description": "Adds a rule to a wallet’s policy. A wallet policy’s rules control the\nconditions under which BitGo will use its single key to sign a\ntransaction. An email notification will be sent to all wallet users\nwhen a policy is updated. This email is NOT sent for the first time\npolicy is added.\n" }, "response": [ { "name": "Add Advanced Whitelist Example", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"my-rule-id\",\n \"type\": \"advancedWhitelist\",\n \"condition\": {\n \"add\": {\n \"type\": \"my-wallet-id\",\n \"item\": \"my-item-id\",\n \"metaData\": {\n \"label\": \"Recipient Wallet\"\n }\n }\n },\n \"action\": {\n \"type\": \"getApproval\",\n \"userIds\": []\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/policy/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "policy", "rule" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"approvalsRequired\": 1,\n \"coin\": \"btc\",\n \"deleted\": false,\n \"disableTransactionNotifications\": true,\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"label\": \"My Wallet\",\n \"admin\": {\n \"policy\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"latest\": true,\n \"rules\": [\n {\n \"id\": \"string\",\n \"lockDate\": \"1991-10-19T22:58:08.721Z\",\n \"type\": \"coinAddressBlacklist\",\n \"action\": {\n \"type\": \"getApproval\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n },\n \"mutabilityConstraint\": \"permanent\",\n \"coin\": \"btc\",\n \"condition\": {\n \"amountString\": \"2000000\",\n \"timeWindow\": 1928182\n }\n },\n {\n \"id\": \"string\",\n \"lockDate\": \"1978-12-28T11:07:16.850Z\",\n \"type\": \"bitcoinAddressWhitelist\",\n \"action\": {\n \"type\": \"getFinalApproval\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n },\n \"mutabilityConstraint\": \"permanent\",\n \"coin\": \"btc\",\n \"condition\": {\n \"amountString\": \"2000000\",\n \"timeWindow\": 679706\n }\n }\n ],\n \"version\": 7071,\n \"date\": \"2008-09-07T18:16:35.693Z\",\n \"label\": \"string\"\n }\n },\n \"allowBackupKeySigning\": true,\n \"balanceString\": \"2000000\",\n \"buildDefaults\": {\n \"minFeeRate\": 12000,\n \"maxFeeRate\": 18000,\n \"feeMultiplier\": 1.2,\n \"changeAddressType\": \"p2wsh\",\n \"txFormat\": \"psbt\",\n \"autoReserveUnspentsOnBuildMins\": 60\n },\n \"coinSpecific\": {\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\",\n \"stellarUsername\": \"foo_bar@baz.com\",\n \"homeDomain\": \"bitgo.com\",\n \"stellarAddress\": \"foo_bar@baz.com*bitgo.com\"\n },\n \"custodialWallet\": {},\n \"custodialWalletId\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"freeze\": {\n \"time\": \"string\",\n \"expires\": \"string\",\n \"reason\": \"UserRequest\",\n \"referenceId\": \"string\",\n \"adminOrUserId\": \"string\"\n },\n \"isCold\": true,\n \"keys\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"m\": 2,\n \"n\": 3,\n \"nodeId\": \"59cd72485007a239fb00282ed480da1f\",\n \"receiveAddress\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 8974,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1991-08-16T08:38:11.934Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 6490,\n \"totalSent\": 8453,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n },\n \"recoverable\": true,\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"spendableBalanceString\": \"2000000\",\n \"unspentCount\": 100,\n \"startDate\": \"1978-03-14T00:17:30.213Z\",\n \"type\": \"custodialPaired\",\n \"users\": [\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"admin\",\n \"trade\"\n ]\n },\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"spend\",\n \"admin\"\n ]\n }\n ],\n \"customChangeKeySignatures\": {\n \"user\": \"string\",\n \"backup\": \"string\",\n \"bitgo\": \"string\"\n },\n \"multisigType\": \"tss\",\n \"multisigTypeVersion\": \"MPCv2\"\n}" }, { "name": "Remove Advanced Whitelist Example", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"my-rule-id\",\n \"type\": \"advancedWhitelist\",\n \"condition\": {\n \"remove\": \"my-address\"\n },\n \"action\": {\n \"type\": \"getApproval\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/policy/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "policy", "rule" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"approvalsRequired\": 1,\n \"coin\": \"btc\",\n \"deleted\": false,\n \"disableTransactionNotifications\": true,\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"label\": \"My Wallet\",\n \"admin\": {\n \"policy\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"latest\": true,\n \"rules\": [\n {\n \"id\": \"string\",\n \"lockDate\": \"1991-10-19T22:58:08.721Z\",\n \"type\": \"coinAddressBlacklist\",\n \"action\": {\n \"type\": \"getApproval\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n },\n \"mutabilityConstraint\": \"permanent\",\n \"coin\": \"btc\",\n \"condition\": {\n \"amountString\": \"2000000\",\n \"timeWindow\": 1928182\n }\n },\n {\n \"id\": \"string\",\n \"lockDate\": \"1978-12-28T11:07:16.850Z\",\n \"type\": \"bitcoinAddressWhitelist\",\n \"action\": {\n \"type\": \"getFinalApproval\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ]\n },\n \"mutabilityConstraint\": \"permanent\",\n \"coin\": \"btc\",\n \"condition\": {\n \"amountString\": \"2000000\",\n \"timeWindow\": 679706\n }\n }\n ],\n \"version\": 7071,\n \"date\": \"2008-09-07T18:16:35.693Z\",\n \"label\": \"string\"\n }\n },\n \"allowBackupKeySigning\": true,\n \"balanceString\": \"2000000\",\n \"buildDefaults\": {\n \"minFeeRate\": 12000,\n \"maxFeeRate\": 18000,\n \"feeMultiplier\": 1.2,\n \"changeAddressType\": \"p2wsh\",\n \"txFormat\": \"psbt\",\n \"autoReserveUnspentsOnBuildMins\": 60\n },\n \"coinSpecific\": {\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\",\n \"stellarUsername\": \"foo_bar@baz.com\",\n \"homeDomain\": \"bitgo.com\",\n \"stellarAddress\": \"foo_bar@baz.com*bitgo.com\"\n },\n \"custodialWallet\": {},\n \"custodialWalletId\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"freeze\": {\n \"time\": \"string\",\n \"expires\": \"string\",\n \"reason\": \"UserRequest\",\n \"referenceId\": \"string\",\n \"adminOrUserId\": \"string\"\n },\n \"isCold\": true,\n \"keys\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"m\": 2,\n \"n\": 3,\n \"nodeId\": \"59cd72485007a239fb00282ed480da1f\",\n \"receiveAddress\": {\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"chain\": 1,\n \"index\": 8974,\n \"coin\": \"string\",\n \"lastNonce\": -1,\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"coinSpecific\": {\n \"xlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n },\n \"txlm\": {\n \"memoId\": \"1\",\n \"rootAddress\": \"GCTTCPH4IIDK7P72FFAEJ3ZFN6WDHJH6GGMRPHPM56ZWGIQ7B3XTIJAM\"\n }\n },\n \"balance\": {\n \"updated\": \"1991-08-16T08:38:11.934Z\",\n \"balance\": 50000,\n \"balanceString\": \"50000\",\n \"totalReceived\": 6490,\n \"totalSent\": 8453,\n \"confirmedBalanceString\": \"40000\",\n \"spendableBalanceString\": \"40000\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"addressType\": \"p2sh\"\n },\n \"recoverable\": true,\n \"tags\": [\n \"59cd72485007a239fb00282ed480da1f\",\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"spendableBalanceString\": \"2000000\",\n \"unspentCount\": 100,\n \"startDate\": \"1978-03-14T00:17:30.213Z\",\n \"type\": \"custodialPaired\",\n \"users\": [\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"admin\",\n \"trade\"\n ]\n },\n {\n \"user\": \"59cd72485007a239fb00282ed480da1f\",\n \"permissions\": [\n \"spend\",\n \"admin\"\n ]\n }\n ],\n \"customChangeKeySignatures\": {\n \"user\": \"string\",\n \"backup\": \"string\",\n \"bitgo\": \"string\"\n },\n \"multisigType\": \"tss\",\n \"multisigTypeVersion\": \"MPCv2\"\n}" }, { "name": "Add Advanced Whitelist Example", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"my-rule-id\",\n \"type\": \"advancedWhitelist\",\n \"condition\": {\n \"add\": {\n \"type\": \"my-wallet-id\",\n \"item\": \"my-item-id\",\n \"metaData\": {\n \"label\": \"Recipient Wallet\"\n }\n }\n },\n \"action\": {\n \"type\": \"getApproval\",\n \"userIds\": []\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/policy/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "policy", "rule" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1989-05-31T09:35:58.829Z\",\n \"info\": {\n \"policyRuleRequest\": {\n \"action\": \"string\",\n \"updateEnterpriseRequest\": {\n \"type\": \"updateEnterpriseRequest\",\n \"action\": \"remove\",\n \"permission\": \"admin\",\n \"userId\": \"string\",\n \"email\": \"user@example.com\"\n }\n },\n \"type\": \"policyRuleRequest\"\n },\n \"state\": \"approved\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"pendingVideoApproval\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Remove Advanced Whitelist Example", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"my-rule-id\",\n \"type\": \"advancedWhitelist\",\n \"condition\": {\n \"remove\": \"my-address\"\n },\n \"action\": {\n \"type\": \"getApproval\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/policy/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "policy", "rule" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"coin\": \"btc\",\n \"wallet\": \"59cd72485007a239fb00282ed480da1f\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"organization\": \"59cd72485007a239fb00282ed480da1f\",\n \"creator\": \"59cd72485007a239fb00282ed480da1f\",\n \"createDate\": \"1989-05-31T09:35:58.829Z\",\n \"info\": {\n \"policyRuleRequest\": {\n \"action\": \"string\",\n \"updateEnterpriseRequest\": {\n \"type\": \"updateEnterpriseRequest\",\n \"action\": \"remove\",\n \"permission\": \"admin\",\n \"userId\": \"string\",\n \"email\": \"user@example.com\"\n }\n },\n \"type\": \"policyRuleRequest\"\n },\n \"state\": \"approved\",\n \"scope\": \"wallet\",\n \"userIds\": [\n \"59cd72485007a239fb00282ed480da1f\"\n ],\n \"approvalsRequired\": 1,\n \"walletLabel\": \"string\",\n \"resolvers\": [\n {\n \"user\": \"string\",\n \"date\": \"string\",\n \"resolutionType\": \"pendingVideoApproval\",\n \"signatures\": [\n \"string\"\n ],\n \"videoApprover\": \"string\",\n \"videoLink\": \"string\",\n \"videoException\": \"string\"\n }\n ],\n \"addressLabels\": [\n {\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"walletLabel\": \"My Wallet\"\n }\n ]\n}" }, { "name": "Add Advanced Whitelist Example", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"my-rule-id\",\n \"type\": \"advancedWhitelist\",\n \"condition\": {\n \"add\": {\n \"type\": \"my-wallet-id\",\n \"item\": \"my-item-id\",\n \"metaData\": {\n \"label\": \"Recipient Wallet\"\n }\n }\n },\n \"action\": {\n \"type\": \"getApproval\",\n \"userIds\": []\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/policy/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "policy", "rule" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" }, { "name": "Remove Advanced Whitelist Example", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"my-rule-id\",\n \"type\": \"advancedWhitelist\",\n \"condition\": {\n \"remove\": \"my-address\"\n },\n \"action\": {\n \"type\": \"getApproval\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/policy/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "policy", "rule" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f", "description": "The wallet ID." } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\",\n \"context\": {}\n}" } ] }, { "name": "Get wallet by ID", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId?allTokens=true&unspentCount=true&includeRbf=true&expandAdvancedWhitelist=true&includeStakingBalances=true&includeBalance=true&exactConfirmedBalance=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId" ], "query": [ { "key": "allTokens", "value": "true", "description": "Include data for all subtokens (i.e. ERC20 Tokens, Stellar Tokens)" }, { "key": "unspentCount", "value": "true", "description": "True, if including unspent count for UTXO-based coins." }, { "key": "includeRbf", "value": "true", "description": "True, if including Replace-By-Fee (RBF) transactions in the total balance amount." }, { "key": "expandAdvancedWhitelist", "value": "true", "description": "True, if including the advanced whitelist wallet address in the response. The address is annotated as part of the whitelist entry metadata" }, { "key": "includeStakingBalances", "value": "true", "description": "Includes the staked balance and reward balance of the wallet" }, { "key": "includeBalance", "value": "true", "description": "Omit trying to fetch the wallet balance" }, { "key": "exactConfirmedBalance", "value": "true", "description": "When set to true, the `confirmedBalance` in the response will be the exact on-chain balance\nwithout considering any unconfirmed transactions (for UTXO-based coins only).\n\nWhen `false`, the `confirmedBalance` will not include the outputs consumed of unconfirmed\nwithdrawals. This may be inaccurate in certain situations\n\nDefault value: false." } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Get one wallet by its 'walletId'. One 'walletId' can map to multiple receive addresses." }, "response": [ { "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId?allTokens=true&unspentCount=true&includeRbf=true&expandAdvancedWhitelist=true&includeStakingBalances=true&includeBalance=true&exactConfirmedBalance=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId" ], "query": [ { "description": "Include data for all subtokens (i.e. ERC20 Tokens, Stellar Tokens)", "key": "allTokens", "value": "true" }, { "description": "True, if including unspent count for UTXO-based coins.", "key": "unspentCount", "value": "true" }, { "description": "True, if including Replace-By-Fee (RBF) transactions in the total balance amount.", "key": "includeRbf", "value": "true" }, { "description": "True, if including the advanced whitelist wallet address in the response. The address is annotated as part of the whitelist entry metadata", "key": "expandAdvancedWhitelist", "value": "true" }, { "description": "Includes the staked balance and reward balance of the wallet", "key": "includeStakingBalances", "value": "true" }, { "description": "Omit trying to fetch the wallet balance", "key": "includeBalance", "value": "true" }, { "description": "When set to true, the `confirmedBalance` in the response will be the exact on-chain balance\nwithout considering any unconfirmed transactions (for UTXO-based coins only).\n\nWhen `false`, the `confirmedBalance` will not include the outputs consumed of unconfirmed\nwithdrawals. This may be inaccurate in certain situations\n\nDefault value: false.", "key": "exactConfirmedBalance", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"allowBackupKeySigning\": false,\n \"approvalsRequired\": 1,\n \"coin\": \"btc\",\n \"coinSpecific\": {\n \"accountHash\": \"string\",\n \"creationFailure\": [\n \"string\",\n \"string\"\n ],\n \"lastTransferId\": \"string\",\n \"pendingChainInitialization\": true,\n \"rootAddress\": \"string\"\n },\n \"deleted\": false,\n \"disableTransactionNotifications\": true,\n \"hasLargeNumberOfAddresses\": true,\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"isCold\": false,\n \"label\": \"My Wallet\",\n \"startDate\": \"1969-07-16T09:41:31.641Z\",\n \"admin\": {\n \"policy\": {\n \"date\": \"2015-04-27T08:13:34.588Z\",\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"latest\": false,\n \"version\": 4472.348786316793,\n \"enterpriseId\": \"string\",\n \"label\": \"string\",\n \"rules\": [\n {\n \"id\": \"string\",\n \"type\": \"coinAddressWhitelist\",\n \"action\": {\n \"type\": \"deny\",\n \"userIds\": [\n \"string\",\n \"string\"\n ]\n },\n \"latest\": false,\n \"version\": 9900.72375972817,\n \"lockDate\": \"1983-09-23T23:39:08.402Z\",\n \"mutabilityConstraint\": \"managed\",\n \"coin\": \"btc\",\n \"condition\": {\n \"lowerBound\": \"string\",\n \"upperBound\": \"string\"\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"coinAddressBlacklist\",\n \"action\": {\n \"type\": \"getSupportManagerApproval\",\n \"userIds\": [\n \"string\",\n \"string\"\n ]\n },\n \"latest\": true,\n \"version\": 7548.068741613387,\n \"lockDate\": \"1958-07-01T04:51:22.827Z\",\n \"mutabilityConstraint\": \"managed\",\n \"coin\": \"btc\",\n \"condition\": {\n \"lowerBound\": \"string\",\n \"upperBound\": \"string\"\n }\n }\n ],\n \"walletId\": \"59cd72485007a239fb00282ed480da1f\"\n }\n },\n \"billingEnterprise\": \"string\",\n \"buildDefaults\": {\n \"minFeeRate\": 12000\n },\n \"clientFlags\": [\n {\n \"name\": \"string\",\n \"value\": false\n },\n {\n \"name\": \"string\",\n \"value\": true\n }\n ],\n \"config\": {\n \"nodeId\": \"\"\n },\n \"custodialWalletId\": \"59cd72485007a239fb00282ed480da1f\",\n \"customChangeKeySignatures\": {\n \"user\": \"string\",\n \"backup\": \"string\",\n \"bitgo\": \"string\"\n },\n \"customerWalletId\": \"string\",\n \"enterprise\": \"59cd72485007a239fb00282ed480da1f\",\n \"evmKeyRingReferenceWalletId\": \"59cd72485007a239fb00282ed480da1f\",\n \"isParent\": true,\n \"enabledChildChains\": [\n \"tbsc\",\n \"tpolygon\"\n ],\n \"organization\": \"string\",\n \"bitgoOrg\": \"string\",\n \"freeze\": {\n \"time\": \"1983-08-13T20:48:33.216Z\",\n \"expires\": \"1949-03-27T10:36:06.018Z\",\n \"reason\": \"TxIntentMismatchApproval\",\n \"referenceId\": \"string\",\n \"adminOrUserId\": \"string\"\n },\n \"instantProvider\": \"string\",\n \"keys\": [\n \"585951a5df8380e0e304a553\",\n \"585951a5df8380e0e30d645c\",\n \"585951a5df8380e0e30b6147\"\n ],\n \"keySignatures\": {\n \"backupPub\": \"string\",\n \"bitgoPub\": \"string\"\n },\n \"m\": 2,\n \"migratedFrom\": \"string\",\n \"multisigType\": \"tss\",\n \"multisigTypeVersion\": \"MPCv2\",\n \"n\": 3,\n \"recoverable\": false,\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"type\": \"cold\",\n \"subType\": \"custodialHot\",\n \"balanceString\": \"string\",\n \"balance\": 966.4383537453314,\n \"confirmedBalanceString\": \"string\",\n \"confirmedBalance\": 2970.1743931262727,\n \"spendableBalanceString\": \"string\",\n \"spendableBalance\": 2794.409023491917,\n \"stakingBalanceString\": \"string\",\n \"rewardBalanceString\": \"string\",\n \"offchain\": {\n \"inboundBalance\": \"string\",\n \"inboundPendingBalance\": \"string\",\n \"inboundUnsettledBalance\": \"string\",\n \"outboundBalance\": \"string\",\n \"outboundPendingBalance\": \"string\",\n \"outboundUnsettledBalance\": \"string\",\n \"outboundLockedBalance\": \"string\",\n \"outboundReservedBalance\": \"string\",\n \"outboundSpendableBalance\": \"string\"\n },\n \"users\": [\n {\n \"permissions\": [\n \"trade\",\n \"spend\"\n ],\n \"needsRecovery\": false,\n \"recoverable\": true,\n \"user\": \"string\"\n },\n {\n \"permissions\": [\n \"spend\",\n \"admin\"\n ],\n \"needsRecovery\": false,\n \"recoverable\": true,\n \"user\": \"string\"\n }\n ],\n \"walletFlags\": [\n {\n \"name\": \"rbf\",\n \"value\": \"string\"\n },\n {\n \"name\": \"suiOfcStaking\",\n \"value\": \"string\"\n }\n ],\n \"receiveAddress\": {\n \"coin\": \"btc\",\n \"wallet\": \"string\",\n \"chain\": 31,\n \"index\": 6079.264222292682,\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"balance\": {\n \"balanceString\": \"500000\",\n \"confirmedBalanceString\": \"400000\",\n \"spendableBalanceString\": \"40000\",\n \"updated\": \"1979-07-01\",\n \"balance\": 50000,\n \"lockedBalanceString\": \"string\",\n \"reservedBalanceString\": \"string\",\n \"totalReceived\": 5313.101133213602,\n \"totalSent\": 5582.280412709209,\n \"transferCount\": 7867.130066900138,\n \"tokens\": {\n \"key_0\": 9097.971719497124,\n \"key_1\": false\n },\n \"nfts\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 5973.7791211909625,\n \"key_3\": true,\n \"key_4\": 3321\n },\n \"unsupportedNfts\": {\n \"key_0\": true,\n \"key_1\": 380,\n \"key_2\": true,\n \"key_3\": false\n },\n \"type\": \"\",\n \"metadata\": \"\"\n },\n \"coinSpecific\": {\n \"rootPub\": \"string\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"lastNonce\": -1,\n \"token\": \"string\",\n \"proof\": \"string\",\n \"signature\": \"string\",\n \"lastConsolidatedTime\": \"2008-06-01\",\n \"needsConsolidation\": true,\n \"tokenConsolidationState\": \"\",\n \"tokenAddress\": \"\"\n }\n}" }, { "name": "Bad Request", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId?allTokens=true&unspentCount=true&includeRbf=true&expandAdvancedWhitelist=true&includeStakingBalances=true&includeBalance=true&exactConfirmedBalance=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId" ], "query": [ { "description": "Include data for all subtokens (i.e. ERC20 Tokens, Stellar Tokens)", "key": "allTokens", "value": "true" }, { "description": "True, if including unspent count for UTXO-based coins.", "key": "unspentCount", "value": "true" }, { "description": "True, if including Replace-By-Fee (RBF) transactions in the total balance amount.", "key": "includeRbf", "value": "true" }, { "description": "True, if including the advanced whitelist wallet address in the response. The address is annotated as part of the whitelist entry metadata", "key": "expandAdvancedWhitelist", "value": "true" }, { "description": "Includes the staked balance and reward balance of the wallet", "key": "includeStakingBalances", "value": "true" }, { "description": "Omit trying to fetch the wallet balance", "key": "includeBalance", "value": "true" }, { "description": "When set to true, the `confirmedBalance` in the response will be the exact on-chain balance\nwithout considering any unconfirmed transactions (for UTXO-based coins only).\n\nWhen `false`, the `confirmedBalance` will not include the outputs consumed of unconfirmed\nwithdrawals. This may be inaccurate in certain situations\n\nDefault value: false.", "key": "exactConfirmedBalance", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" }, { "name": "Unauthorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId?allTokens=true&unspentCount=true&includeRbf=true&expandAdvancedWhitelist=true&includeStakingBalances=true&includeBalance=true&exactConfirmedBalance=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId" ], "query": [ { "description": "Include data for all subtokens (i.e. ERC20 Tokens, Stellar Tokens)", "key": "allTokens", "value": "true" }, { "description": "True, if including unspent count for UTXO-based coins.", "key": "unspentCount", "value": "true" }, { "description": "True, if including Replace-By-Fee (RBF) transactions in the total balance amount.", "key": "includeRbf", "value": "true" }, { "description": "True, if including the advanced whitelist wallet address in the response. The address is annotated as part of the whitelist entry metadata", "key": "expandAdvancedWhitelist", "value": "true" }, { "description": "Includes the staked balance and reward balance of the wallet", "key": "includeStakingBalances", "value": "true" }, { "description": "Omit trying to fetch the wallet balance", "key": "includeBalance", "value": "true" }, { "description": "When set to true, the `confirmedBalance` in the response will be the exact on-chain balance\nwithout considering any unconfirmed transactions (for UTXO-based coins only).\n\nWhen `false`, the `confirmedBalance` will not include the outputs consumed of unconfirmed\nwithdrawals. This may be inaccurate in certain situations\n\nDefault value: false.", "key": "exactConfirmedBalance", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" }, { "name": "Forbidden", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId?allTokens=true&unspentCount=true&includeRbf=true&expandAdvancedWhitelist=true&includeStakingBalances=true&includeBalance=true&exactConfirmedBalance=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId" ], "query": [ { "description": "Include data for all subtokens (i.e. ERC20 Tokens, Stellar Tokens)", "key": "allTokens", "value": "true" }, { "description": "True, if including unspent count for UTXO-based coins.", "key": "unspentCount", "value": "true" }, { "description": "True, if including Replace-By-Fee (RBF) transactions in the total balance amount.", "key": "includeRbf", "value": "true" }, { "description": "True, if including the advanced whitelist wallet address in the response. The address is annotated as part of the whitelist entry metadata", "key": "expandAdvancedWhitelist", "value": "true" }, { "description": "Includes the staked balance and reward balance of the wallet", "key": "includeStakingBalances", "value": "true" }, { "description": "Omit trying to fetch the wallet balance", "key": "includeBalance", "value": "true" }, { "description": "When set to true, the `confirmedBalance` in the response will be the exact on-chain balance\nwithout considering any unconfirmed transactions (for UTXO-based coins only).\n\nWhen `false`, the `confirmedBalance` will not include the outputs consumed of unconfirmed\nwithdrawals. This may be inaccurate in certain situations\n\nDefault value: false.", "key": "exactConfirmedBalance", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" }, { "name": "Not Found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId?allTokens=true&unspentCount=true&includeRbf=true&expandAdvancedWhitelist=true&includeStakingBalances=true&includeBalance=true&exactConfirmedBalance=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId" ], "query": [ { "description": "Include data for all subtokens (i.e. ERC20 Tokens, Stellar Tokens)", "key": "allTokens", "value": "true" }, { "description": "True, if including unspent count for UTXO-based coins.", "key": "unspentCount", "value": "true" }, { "description": "True, if including Replace-By-Fee (RBF) transactions in the total balance amount.", "key": "includeRbf", "value": "true" }, { "description": "True, if including the advanced whitelist wallet address in the response. The address is annotated as part of the whitelist entry metadata", "key": "expandAdvancedWhitelist", "value": "true" }, { "description": "Includes the staked balance and reward balance of the wallet", "key": "includeStakingBalances", "value": "true" }, { "description": "Omit trying to fetch the wallet balance", "key": "includeBalance", "value": "true" }, { "description": "When set to true, the `confirmedBalance` in the response will be the exact on-chain balance\nwithout considering any unconfirmed transactions (for UTXO-based coins only).\n\nWhen `false`, the `confirmedBalance` will not include the outputs consumed of unconfirmed\nwithdrawals. This may be inaccurate in certain situations\n\nDefault value: false.", "key": "exactConfirmedBalance", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" }, { "name": "Internal Server Error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/wallet/:walletId?allTokens=true&unspentCount=true&includeRbf=true&expandAdvancedWhitelist=true&includeStakingBalances=true&includeBalance=true&exactConfirmedBalance=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "wallet", ":walletId" ], "query": [ { "description": "Include data for all subtokens (i.e. ERC20 Tokens, Stellar Tokens)", "key": "allTokens", "value": "true" }, { "description": "True, if including unspent count for UTXO-based coins.", "key": "unspentCount", "value": "true" }, { "description": "True, if including Replace-By-Fee (RBF) transactions in the total balance amount.", "key": "includeRbf", "value": "true" }, { "description": "True, if including the advanced whitelist wallet address in the response. The address is annotated as part of the whitelist entry metadata", "key": "expandAdvancedWhitelist", "value": "true" }, { "description": "Includes the staked balance and reward balance of the wallet", "key": "includeStakingBalances", "value": "true" }, { "description": "Omit trying to fetch the wallet balance", "key": "includeBalance", "value": "true" }, { "description": "When set to true, the `confirmedBalance` in the response will be the exact on-chain balance\nwithout considering any unconfirmed transactions (for UTXO-based coins only).\n\nWhen `false`, the `confirmedBalance` will not include the outputs consumed of unconfirmed\nwithdrawals. This may be inaccurate in certain situations\n\nDefault value: false.", "key": "exactConfirmedBalance", "value": "true" } ], "variable": [ { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" } ] } ] }, { "name": "Create Addresses", "item": [ { "name": "Create address", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"chain\": 1,\n \"forwarderVersion\": 4.338293662651323,\n \"evmKeyRingReferenceAddress\": \"string\",\n \"onToken\": \"ofcbtc\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"lowPriority\": false,\n \"gasPrice\": \"string\",\n \"eip1559\": {\n \"maxFeePerGas\": 3184.018126435553,\n \"maxPriorityFeePerGas\": 4458.048958025871\n },\n \"format\": \"cashaddr\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/address", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "address" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "Creates a new receive address for a wallet. If you create a forwarder address, whenever it receives assets, BitGo automatically deploys a forwarder smart contract to flush the balance to the base address. See [Blockchain Reference](https://assets.bitgo.com/coins/agoric) topics to learn more about address management, fees, and consolidations for specific assets.\n**Note:** New Ethereum addresses require blockchain confirmation before you can consolidate from them." }, "response": [ { "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"chain\": 1,\n \"forwarderVersion\": 4.338293662651323,\n \"evmKeyRingReferenceAddress\": \"string\",\n \"onToken\": \"ofcbtc\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"lowPriority\": false,\n \"gasPrice\": \"string\",\n \"eip1559\": {\n \"maxFeePerGas\": 3184.018126435553,\n \"maxPriorityFeePerGas\": 4458.048958025871\n },\n \"format\": \"cashaddr\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/address", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "address" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"coin\": \"btc\",\n \"wallet\": \"string\",\n \"chain\": 10,\n \"index\": 6365.797221183926,\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"balance\": {\n \"balanceString\": \"500000\",\n \"confirmedBalanceString\": \"400000\",\n \"spendableBalanceString\": \"40000\",\n \"updated\": \"1960-08-05\",\n \"balance\": 50000,\n \"lockedBalanceString\": \"string\",\n \"reservedBalanceString\": \"string\",\n \"totalReceived\": 4120.218817361132,\n \"totalSent\": 5154.7114357520595,\n \"transferCount\": 1725.9099711867498,\n \"tokens\": {\n \"key_0\": \"string\",\n \"key_1\": 2841.552865446366\n },\n \"nfts\": {\n \"key_0\": 6499\n },\n \"unsupportedNfts\": {\n \"key_0\": 3788,\n \"key_1\": \"string\"\n },\n \"type\": \"\",\n \"metadata\": \"\"\n },\n \"coinSpecific\": {\n \"rootAddress\": \"string\",\n \"memoId\": \"string\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"lastNonce\": -1,\n \"token\": \"string\",\n \"proof\": \"string\",\n \"signature\": \"string\",\n \"lastConsolidatedTime\": \"1958-02-07\",\n \"needsConsolidation\": true,\n \"tokenConsolidationState\": \"\",\n \"tokenAddress\": \"\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"chain\": 1,\n \"forwarderVersion\": 4.338293662651323,\n \"evmKeyRingReferenceAddress\": \"string\",\n \"onToken\": \"ofcbtc\",\n \"label\": \"Bob's Hot Wallet Address\",\n \"lowPriority\": false,\n \"gasPrice\": \"string\",\n \"eip1559\": {\n \"maxFeePerGas\": 3184.018126435553,\n \"maxPriorityFeePerGas\": 4458.048958025871\n },\n \"format\": \"cashaddr\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/address", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "address" ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" } ] }, { "name": "List addresses", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/addresses?includeBalances=false&includeTokens=false&includeAllTokenAddresses=false&labelContains=string&limit=25&sort=1&sortedField=token&sortedFieldDirection=1&chains=1&chains=1&includeTotalAddressCount=false&prevId=59cd72485007a239fb00282ed480da1f&token=ofctbtc&token=ofctbtc&returnBalancesForToken=string&pendingDeployment=string&segwit=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "addresses" ], "query": [ { "key": "includeBalances", "value": "false", "description": "Whether to include address balances" }, { "key": "includeTokens", "value": "false", "description": "Whether to include token addresses" }, { "key": "includeAllTokenAddresses", "value": "false", "description": "Whether to include all token addresses for receiver addresses" }, { "key": "labelContains", "value": "string", "description": "A case-insensitive regular expression which will be used to filter returned addresses based on their address label." }, { "key": "limit", "value": "25", "description": "Maximum number of results to return" }, { "key": "sort", "value": "1", "description": "Sort order of returned addresses. (1 for ascending, -1 for descending)" }, { "key": "sortedField", "value": "token", "description": "The field by which addresses will be sorted, if not provided then sort by id by default" }, { "key": "sortedFieldDirection", "value": "1", "description": "Sort order of the returned addresses on the sortedField" }, { "key": "chains", "value": "1", "description": "Filter by address chains" }, { "key": "chains", "value": "1", "description": "Filter by address chains" }, { "key": "includeTotalAddressCount", "value": "false", "description": "For large wallets (>100k addresses), include total count of addresses (including addresses pending on-chain) matching the query." }, { "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f", "description": "Return the next batch of results, based on the nextBatchPrevId value from the previous batch" }, { "key": "token", "value": "ofctbtc", "description": "This param is used to query and filter addresses by token names in case of ofc wallets" }, { "key": "token", "value": "ofctbtc", "description": "This param is used to query and filter addresses by token names in case of ofc wallets" }, { "key": "returnBalancesForToken", "value": "string", "description": "Name of the token that the response should include balances for. (Eth and Celo only)" }, { "key": "pendingDeployment", "value": "string", "description": "Filter the addresses based on their deployment status. Return the deployed addresses if this param is passed as false and return undeployed addresses if it is passed as true. (Eth only)" }, { "key": "segwit", "value": "true", "description": "DEPRECATED. Mutually exclusive with 'chains'. Returns only 'p2shP2wsh' unspents/addresses on true. Returns only 'p2sh' unspents/addresses on false. Equivalent to passing 10 and 11 as the only value in 'chains' on true, 0 and 1 on false." } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] }, "description": "List receive addresses on a wallet" }, "response": [ { "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/addresses?includeBalances=false&includeTokens=false&includeAllTokenAddresses=false&labelContains=string&limit=25&sort=1&sortedField=token&sortedFieldDirection=1&chains=1&includeTotalAddressCount=false&prevId=59cd72485007a239fb00282ed480da1f&token=ofctbtc&returnBalancesForToken=string&pendingDeployment=string&segwit=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "addresses" ], "query": [ { "description": "Whether to include address balances", "key": "includeBalances", "value": "false" }, { "description": "Whether to include token addresses", "key": "includeTokens", "value": "false" }, { "description": "Whether to include all token addresses for receiver addresses", "key": "includeAllTokenAddresses", "value": "false" }, { "description": "A case-insensitive regular expression which will be used to filter returned addresses based on their address label.", "key": "labelContains", "value": "string" }, { "description": "Maximum number of results to return", "key": "limit", "value": "25" }, { "description": "Sort order of returned addresses. (1 for ascending, -1 for descending)", "key": "sort", "value": "1" }, { "description": "The field by which addresses will be sorted, if not provided then sort by id by default", "key": "sortedField", "value": "token" }, { "description": "Sort order of the returned addresses on the sortedField", "key": "sortedFieldDirection", "value": "1" }, { "description": "Filter by address chains", "key": "chains", "value": "1" }, { "description": "For large wallets (>100k addresses), include total count of addresses (including addresses pending on-chain) matching the query.", "key": "includeTotalAddressCount", "value": "false" }, { "description": "Return the next batch of results, based on the nextBatchPrevId value from the previous batch", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "description": "This param is used to query and filter addresses by token names in case of ofc wallets", "key": "token", "value": "ofctbtc" }, { "description": "Name of the token that the response should include balances for. (Eth and Celo only)", "key": "returnBalancesForToken", "value": "string" }, { "description": "Filter the addresses based on their deployment status. Return the deployed addresses if this param is passed as false and return undeployed addresses if it is passed as true. (Eth only)", "key": "pendingDeployment", "value": "string" }, { "description": "DEPRECATED. Mutually exclusive with 'chains'. Returns only 'p2shP2wsh' unspents/addresses on true. Returns only 'p2sh' unspents/addresses on false. Equivalent to passing 10 and 11 as the only value in 'chains' on true, 0 and 1 on false.", "key": "segwit", "value": "true" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"coin\": \"btc\",\n \"pendingAddressCount\": 8439.258445366195,\n \"totalAddressCount\": 5140.466119282119,\n \"addresses\": [\n {\n \"chain\": 31,\n \"coin\": \"btc\",\n \"index\": 7740.717423500922,\n \"wallet\": \"string\",\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"balance\": {\n \"balanceString\": \"500000\",\n \"confirmedBalanceString\": \"400000\",\n \"spendableBalanceString\": \"40000\",\n \"updated\": \"1985-06-08\",\n \"balance\": 50000,\n \"lockedBalanceString\": \"string\",\n \"reservedBalanceString\": \"string\",\n \"totalReceived\": 4970.347807193112,\n \"totalSent\": 9261.470610377828,\n \"transferCount\": 8064.4633335002,\n \"tokens\": {\n \"key_0\": 8869,\n \"key_1\": 971,\n \"key_2\": 806.7699683526008,\n \"key_3\": 4926,\n \"key_4\": 3717.371440685262\n },\n \"nfts\": {\n \"key_0\": true,\n \"key_1\": 3527.4618153197366,\n \"key_2\": \"string\"\n },\n \"unsupportedNfts\": {\n \"key_0\": 3903.323412131625\n },\n \"type\": \"\",\n \"metadata\": \"\"\n },\n \"coinSpecific\": {\n \"rootPub\": \"string\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"lastNonce\": -1,\n \"token\": \"string\",\n \"proof\": \"string\",\n \"signature\": \"string\",\n \"lastConsolidatedTime\": \"1953-04-16\",\n \"needsConsolidation\": true,\n \"tokenConsolidationState\": \"\",\n \"tokenAddress\": \"\"\n },\n {\n \"chain\": 10,\n \"coin\": \"btc\",\n \"index\": 6719.468690252752,\n \"wallet\": \"string\",\n \"id\": \"59cd72485007a239fb00282ed480da1f\",\n \"address\": \"2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS\",\n \"balance\": {\n \"balanceString\": \"500000\",\n \"confirmedBalanceString\": \"400000\",\n \"spendableBalanceString\": \"40000\",\n \"updated\": \"1953-10-14\",\n \"balance\": 50000,\n \"lockedBalanceString\": \"string\",\n \"reservedBalanceString\": \"string\",\n \"totalReceived\": 3856.2126624585026,\n \"totalSent\": 9495.313621135894,\n \"transferCount\": 5622.443469566989,\n \"tokens\": {\n \"key_0\": 8279\n },\n \"nfts\": {\n \"key_0\": true,\n \"key_1\": 9864,\n \"key_2\": 9433.204954599416\n },\n \"unsupportedNfts\": {\n \"key_0\": \"string\",\n \"key_1\": 5162.446154216403\n },\n \"type\": \"\",\n \"metadata\": \"\"\n },\n \"coinSpecific\": {\n \"rootPub\": \"string\"\n },\n \"label\": \"Bob's Hot Wallet Address\",\n \"lastNonce\": -1,\n \"token\": \"string\",\n \"proof\": \"string\",\n \"signature\": \"string\",\n \"lastConsolidatedTime\": \"1986-02-10\",\n \"needsConsolidation\": true,\n \"tokenConsolidationState\": \"\",\n \"tokenAddress\": \"\"\n }\n ],\n \"nextBatchPrevId\": \"07173d84-0ee6-9069-47e0-1480dc4d32ab\",\n \"count\": 5112.195179109657\n}" }, { "name": "Accepted", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/addresses?includeBalances=false&includeTokens=false&includeAllTokenAddresses=false&labelContains=string&limit=25&sort=1&sortedField=token&sortedFieldDirection=1&chains=1&includeTotalAddressCount=false&prevId=59cd72485007a239fb00282ed480da1f&token=ofctbtc&returnBalancesForToken=string&pendingDeployment=string&segwit=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "addresses" ], "query": [ { "description": "Whether to include address balances", "key": "includeBalances", "value": "false" }, { "description": "Whether to include token addresses", "key": "includeTokens", "value": "false" }, { "description": "Whether to include all token addresses for receiver addresses", "key": "includeAllTokenAddresses", "value": "false" }, { "description": "A case-insensitive regular expression which will be used to filter returned addresses based on their address label.", "key": "labelContains", "value": "string" }, { "description": "Maximum number of results to return", "key": "limit", "value": "25" }, { "description": "Sort order of returned addresses. (1 for ascending, -1 for descending)", "key": "sort", "value": "1" }, { "description": "The field by which addresses will be sorted, if not provided then sort by id by default", "key": "sortedField", "value": "token" }, { "description": "Sort order of the returned addresses on the sortedField", "key": "sortedFieldDirection", "value": "1" }, { "description": "Filter by address chains", "key": "chains", "value": "1" }, { "description": "For large wallets (>100k addresses), include total count of addresses (including addresses pending on-chain) matching the query.", "key": "includeTotalAddressCount", "value": "false" }, { "description": "Return the next batch of results, based on the nextBatchPrevId value from the previous batch", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "description": "This param is used to query and filter addresses by token names in case of ofc wallets", "key": "token", "value": "ofctbtc" }, { "description": "Name of the token that the response should include balances for. (Eth and Celo only)", "key": "returnBalancesForToken", "value": "string" }, { "description": "Filter the addresses based on their deployment status. Return the deployed addresses if this param is passed as false and return undeployed addresses if it is passed as true. (Eth only)", "key": "pendingDeployment", "value": "string" }, { "description": "DEPRECATED. Mutually exclusive with 'chains'. Returns only 'p2shP2wsh' unspents/addresses on true. Returns only 'p2sh' unspents/addresses on false. Equivalent to passing 10 and 11 as the only value in 'chains' on true, 0 and 1 on false.", "key": "segwit", "value": "true" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" }, { "name": "Bad Request", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/addresses?includeBalances=false&includeTokens=false&includeAllTokenAddresses=false&labelContains=string&limit=25&sort=1&sortedField=token&sortedFieldDirection=1&chains=1&includeTotalAddressCount=false&prevId=59cd72485007a239fb00282ed480da1f&token=ofctbtc&returnBalancesForToken=string&pendingDeployment=string&segwit=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "addresses" ], "query": [ { "description": "Whether to include address balances", "key": "includeBalances", "value": "false" }, { "description": "Whether to include token addresses", "key": "includeTokens", "value": "false" }, { "description": "Whether to include all token addresses for receiver addresses", "key": "includeAllTokenAddresses", "value": "false" }, { "description": "A case-insensitive regular expression which will be used to filter returned addresses based on their address label.", "key": "labelContains", "value": "string" }, { "description": "Maximum number of results to return", "key": "limit", "value": "25" }, { "description": "Sort order of returned addresses. (1 for ascending, -1 for descending)", "key": "sort", "value": "1" }, { "description": "The field by which addresses will be sorted, if not provided then sort by id by default", "key": "sortedField", "value": "token" }, { "description": "Sort order of the returned addresses on the sortedField", "key": "sortedFieldDirection", "value": "1" }, { "description": "Filter by address chains", "key": "chains", "value": "1" }, { "description": "For large wallets (>100k addresses), include total count of addresses (including addresses pending on-chain) matching the query.", "key": "includeTotalAddressCount", "value": "false" }, { "description": "Return the next batch of results, based on the nextBatchPrevId value from the previous batch", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "description": "This param is used to query and filter addresses by token names in case of ofc wallets", "key": "token", "value": "ofctbtc" }, { "description": "Name of the token that the response should include balances for. (Eth and Celo only)", "key": "returnBalancesForToken", "value": "string" }, { "description": "Filter the addresses based on their deployment status. Return the deployed addresses if this param is passed as false and return undeployed addresses if it is passed as true. (Eth only)", "key": "pendingDeployment", "value": "string" }, { "description": "DEPRECATED. Mutually exclusive with 'chains'. Returns only 'p2shP2wsh' unspents/addresses on true. Returns only 'p2sh' unspents/addresses on false. Equivalent to passing 10 and 11 as the only value in 'chains' on true, 0 and 1 on false.", "key": "segwit", "value": "true" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" }, { "name": "Forbidden", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/:coin/wallet/:walletId/addresses?includeBalances=false&includeTokens=false&includeAllTokenAddresses=false&labelContains=string&limit=25&sort=1&sortedField=token&sortedFieldDirection=1&chains=1&includeTotalAddressCount=false&prevId=59cd72485007a239fb00282ed480da1f&token=ofctbtc&returnBalancesForToken=string&pendingDeployment=string&segwit=true", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", ":coin", "wallet", ":walletId", "addresses" ], "query": [ { "description": "Whether to include address balances", "key": "includeBalances", "value": "false" }, { "description": "Whether to include token addresses", "key": "includeTokens", "value": "false" }, { "description": "Whether to include all token addresses for receiver addresses", "key": "includeAllTokenAddresses", "value": "false" }, { "description": "A case-insensitive regular expression which will be used to filter returned addresses based on their address label.", "key": "labelContains", "value": "string" }, { "description": "Maximum number of results to return", "key": "limit", "value": "25" }, { "description": "Sort order of returned addresses. (1 for ascending, -1 for descending)", "key": "sort", "value": "1" }, { "description": "The field by which addresses will be sorted, if not provided then sort by id by default", "key": "sortedField", "value": "token" }, { "description": "Sort order of the returned addresses on the sortedField", "key": "sortedFieldDirection", "value": "1" }, { "description": "Filter by address chains", "key": "chains", "value": "1" }, { "description": "For large wallets (>100k addresses), include total count of addresses (including addresses pending on-chain) matching the query.", "key": "includeTotalAddressCount", "value": "false" }, { "description": "Return the next batch of results, based on the nextBatchPrevId value from the previous batch", "key": "prevId", "value": "59cd72485007a239fb00282ed480da1f" }, { "description": "This param is used to query and filter addresses by token names in case of ofc wallets", "key": "token", "value": "ofctbtc" }, { "description": "Name of the token that the response should include balances for. (Eth and Celo only)", "key": "returnBalancesForToken", "value": "string" }, { "description": "Filter the addresses based on their deployment status. Return the deployed addresses if this param is passed as false and return undeployed addresses if it is passed as true. (Eth only)", "key": "pendingDeployment", "value": "string" }, { "description": "DEPRECATED. Mutually exclusive with 'chains'. Returns only 'p2shP2wsh' unspents/addresses on true. Returns only 'p2sh' unspents/addresses on false. Equivalent to passing 10 and 11 as the only value in 'chains' on true, 0 and 1 on false.", "key": "segwit", "value": "true" } ], "variable": [ { "key": "coin", "value": "btc" }, { "key": "walletId", "value": "59cd72485007a239fb00282ed480da1f" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"context\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"error\": \"string\",\n \"requestId\": \"string\",\n \"name\": \"string\"\n}" } ] } ] } ] }