{ "info": { "_postman_id": "b6f0f6a4-6c0a-4f0e-9a34-7a2f5d1c9e01", "name": "Rarebl Open API", "description": "Blockchain data and tools for BTC, LTC, BCH, DASH, ETH and TRON from Rarebl's own nodes: reads, transactions, signing, addresses, webhooks and market data. No API keys: every request is keyless and limited per IP by rate class.\n\nThe WebSocket stream (wss://api.rarebl.com/ws) cannot be called from Postman's HTTP requests: see https://docs.rarebl.com/api/websocket.\n\nDocumentation: https://docs.rarebl.com\nBase URL: https://api.rarebl.com/open", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "baseUrl", "value": "https://api.rarebl.com/open", "type": "string" }, { "key": "hookId", "value": "", "type": "string" }, { "key": "manageToken", "value": "", "type": "string" }, { "key": "apiKey", "value": "", "type": "string" } ], "item": [ { "name": "Stats", "description": "Chain list and live heads for all six chains.", "item": [ { "name": "Chains", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/stats/chains", "host": [ "{{baseUrl}}" ], "path": [ "stats", "chains" ], "query": [] }, "description": "List the six supported chains with their identity, units, current tip, health and which features each one supports today.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/stats/chains\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/stats/chains", "host": [ "{{baseUrl}}" ], "path": [ "stats", "chains" ], "query": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"chains\": [\n {\n \"id\": \"btc\",\n \"name\": \"Bitcoin\",\n \"symbol\": \"BTC\",\n \"decimals\": 8,\n \"kind\": \"utxo\",\n \"status\": \"ok\",\n \"tip\": {\n \"height\": 975854,\n \"hash\": \"00000000000000000000ac4918a89711fb90ab487b7e21d02995f39d88a83b9c\",\n \"time\": \"2026-11-14T22:25:13Z\"\n },\n \"historyFrom\": null,\n \"features\": {\n \"addressHistory\": false,\n \"addressBalance\": false,\n \"tokens\": false,\n \"mempool\": true,\n \"internalTxs\": false\n }\n },\n {\n \"id\": \"ltc\",\n \"name\": \"Litecoin\",\n \"symbol\": \"LTC\",\n \"decimals\": 8,\n \"kind\": \"utxo\",\n \"status\": \"ok\",\n \"tip\": {\n \"height\": 3213201,\n \"hash\": \"e7b72ef9f34b8f61b2b5dabec238088bf1198fe9779df88f5b1a87c8e3f276e7\",\n \"time\": \"2026-11-14T22:38:19Z\"\n },\n \"historyFrom\": null,\n \"features\": {\n \"addressHistory\": false,\n \"addressBalance\": false,\n \"tokens\": false,\n \"mempool\": true,\n \"internalTxs\": false\n }\n },\n {\n \"id\": \"bch\",\n \"name\": \"Bitcoin Cash\",\n \"symbol\": \"BCH\",\n \"decimals\": 8,\n \"kind\": \"utxo\",\n \"status\": \"ok\",\n \"tip\": {\n \"height\": 977391,\n \"hash\": \"00000000000000000130fbfa0ec402f4fca4b414cdff8d264e4caa225c9ea81e\",\n \"time\": \"2026-11-14T22:39:19Z\"\n },\n \"historyFrom\": null,\n \"features\": {\n \"addressHistory\": false,\n \"addressBalance\": false,\n \"tokens\": false,\n \"mempool\": true,\n \"internalTxs\": false\n }\n },\n {\n \"id\": \"dash\",\n \"name\": \"Dash\",\n \"symbol\": \"DASH\",\n \"decimals\": 8,\n \"kind\": \"utxo\",\n \"status\": \"ok\",\n \"tip\": {\n \"height\": 2572373,\n \"hash\": \"0000000000000008ef6f834cf172cb739f5542f0ad1f7103c9a22d65be56f064\",\n \"time\": \"2026-11-14T22:37:02Z\"\n },\n \"historyFrom\": null,\n \"features\": {\n \"addressHistory\": true,\n \"addressBalance\": true,\n \"tokens\": false,\n \"mempool\": true,\n \"internalTxs\": false\n }\n },\n {\n \"id\": \"eth\",\n \"name\": \"Ethereum\",\n \"symbol\": \"ETH\",\n \"decimals\": 18,\n \"kind\": \"account\",\n \"status\": \"lagging\",\n \"tip\": null,\n \"historyFrom\": null,\n \"features\": {\n \"addressHistory\": false,\n \"addressBalance\": true,\n \"tokens\": true,\n \"mempool\": true,\n \"internalTxs\": false\n }\n },\n {\n \"id\": \"tron\",\n \"name\": \"TRON\",\n \"symbol\": \"TRX\",\n \"decimals\": 6,\n \"kind\": \"account\",\n \"status\": \"lagging\",\n \"tip\": {\n \"height\": 88007289,\n \"hash\": \"00000000053ee279103116c09576a469acc68fe6ab27ffa89d3358ca59a3fc78\",\n \"time\": \"2026-11-14T22:36:06Z\"\n },\n \"historyFrom\": \"2026-09-08T17:50:00Z\",\n \"features\": {\n \"addressHistory\": false,\n \"addressBalance\": true,\n \"tokens\": true,\n \"mempool\": true,\n \"internalTxs\": false\n }\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/stats/chains", "host": [ "{{baseUrl}}" ], "path": [ "stats", "chains" ], "query": [] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/stats/chains", "host": [ "{{baseUrl}}" ], "path": [ "stats", "chains" ], "query": [] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Live stats", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/stats/live", "host": [ "{{baseUrl}}" ], "path": [ "stats", "live" ], "query": [] }, "description": "One cheap call with the head of every chain: tip, mempool size and the current fee. Refreshed about every 2 seconds, so it is the one to poll.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/stats/live\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/stats/live", "host": [ "{{baseUrl}}" ], "path": [ "stats", "live" ], "query": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"serverTime\": \"2026-11-14T22:39:43Z\",\n \"chains\": [\n {\n \"id\": \"btc\",\n \"status\": \"ok\",\n \"tip\": {\n \"height\": 975854,\n \"hash\": \"00000000000000000000ac4918a89711fb90ab487b7e21d02995f39d88a83b9c\",\n \"time\": \"2026-11-14T22:25:13Z\"\n },\n \"mempool\": {\n \"count\": 70161,\n \"bytes\": 25261120\n },\n \"fee\": {\n \"unit\": \"sat/vB\",\n \"standard\": \"0.13\"\n },\n \"checkedAt\": \"2026-11-14T22:39:43Z\"\n },\n {\n \"id\": \"ltc\",\n \"status\": \"ok\",\n \"tip\": {\n \"height\": 3213201,\n \"hash\": \"e7b72ef9f34b8f61b2b5dabec238088bf1198fe9779df88f5b1a87c8e3f276e7\",\n \"time\": \"2026-11-14T22:38:19Z\"\n },\n \"mempool\": {\n \"count\": 172,\n \"bytes\": 50642\n },\n \"fee\": {\n \"unit\": \"sat/vB\",\n \"standard\": \"1\"\n },\n \"checkedAt\": \"2026-11-14T22:39:43Z\"\n },\n {\n \"id\": \"bch\",\n \"status\": \"ok\",\n \"tip\": {\n \"height\": 977391,\n \"hash\": \"00000000000000000130fbfa0ec402f4fca4b414cdff8d264e4caa225c9ea81e\",\n \"time\": \"2026-11-14T22:39:19Z\"\n },\n \"mempool\": {\n \"count\": 2,\n \"bytes\": 1163\n },\n \"fee\": {\n \"unit\": \"sat/vB\",\n \"standard\": \"1\"\n },\n \"checkedAt\": \"2026-11-14T22:39:43Z\"\n },\n {\n \"id\": \"dash\",\n \"status\": \"ok\",\n \"tip\": {\n \"height\": 2572373,\n \"hash\": \"0000000000000008ef6f834cf172cb739f5542f0ad1f7103c9a22d65be56f064\",\n \"time\": \"2026-11-14T22:37:02Z\"\n },\n \"mempool\": {\n \"count\": 26,\n \"bytes\": 18576\n },\n \"fee\": {\n \"unit\": \"sat/vB\",\n \"standard\": \"1\"\n },\n \"checkedAt\": \"2026-11-14T22:39:43Z\"\n },\n {\n \"id\": \"eth\",\n \"status\": \"lagging\",\n \"tip\": null,\n \"mempool\": null,\n \"fee\": null,\n \"checkedAt\": \"2026-11-14T22:39:43Z\"\n },\n {\n \"id\": \"tron\",\n \"status\": \"lagging\",\n \"tip\": {\n \"height\": 88007289,\n \"hash\": \"00000000053ee279103116c09576a469acc68fe6ab27ffa89d3358ca59a3fc78\",\n \"time\": \"2026-11-14T22:36:06Z\"\n },\n \"mempool\": {\n \"count\": 0,\n \"bytes\": null\n },\n \"fee\": {\n \"unit\": \"sun\",\n \"standard\": \"100\"\n },\n \"checkedAt\": \"2026-11-14T22:39:43Z\"\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/stats/live", "host": [ "{{baseUrl}}" ], "path": [ "stats", "live" ], "query": [] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Token", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/token/info?chain=tron&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "host": [ "{{baseUrl}}" ], "path": [ "token", "info" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "contract", "value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "description": "The token contract address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] }, "description": "Metadata of a token contract on ETH or TRON: standard, name, symbol, decimals and total supply.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/token/info\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/token/info?chain=tron&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "host": [ "{{baseUrl}}" ], "path": [ "token", "info" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "contract", "value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "description": "The token contract address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"token\": {\n \"chain\": \"tron\",\n \"contract\": \"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\",\n \"standard\": \"TRC-20\",\n \"name\": \"Tether USD\",\n \"symbol\": \"USDT\",\n \"decimals\": 6,\n \"totalSupply\": \"94207597532.054777\",\n \"holders\": null,\n \"transfers\": null,\n \"details\": [\n {\n \"key\": \"standard\",\n \"label\": \"Standard\",\n \"value\": \"TRC-20\",\n \"kind\": \"text\"\n },\n {\n \"key\": \"contract\",\n \"label\": \"Contract\",\n \"value\": \"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\",\n \"kind\": \"address\"\n },\n {\n \"key\": \"decimals\",\n \"label\": \"Decimals\",\n \"value\": 6,\n \"kind\": \"number\"\n }\n ]\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/token/info?chain=tron&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "host": [ "{{baseUrl}}" ], "path": [ "token", "info" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "contract", "value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "description": "The token contract address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Tokens exist on eth and tron only.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/token/info?chain=tron&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "host": [ "{{baseUrl}}" ], "path": [ "token", "info" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "contract", "value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "description": "The token contract address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"No contract at this address.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/token/info?chain=tron&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "host": [ "{{baseUrl}}" ], "path": [ "token", "info" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "contract", "value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "description": "The token contract address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/token/info?chain=tron&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "host": [ "{{baseUrl}}" ], "path": [ "token", "info" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "contract", "value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "description": "The token contract address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] }, { "name": "Blocks", "description": "Latest blocks and block detail.", "item": [ { "name": "Latest blocks", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/block/latest?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "latest" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "before", "value": "", "description": "Return blocks below this height (exclusive). Pass the previous reply's `next`. Block height, 0 or higher.", "disabled": true }, { "key": "limit", "value": "2", "description": "Number of blocks to return. 1 to 25 (larger values are capped at 25)", "disabled": false } ] }, "description": "The newest blocks of a chain, newest first, with a cursor to page back in time.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/block/latest\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/latest?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "latest" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Number of blocks to return. 1 to 25 (larger values are capped at 25)", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"items\": [\n {\n \"height\": 975852,\n \"hash\": \"0000000000000000000106d2c49ad20a447077c0ee2a8000a0bf7dca0df81fc5\",\n \"time\": \"2026-11-14T22:21:59Z\",\n \"txCount\": 2749,\n \"size\": 1630627,\n \"miner\": \"32i1m6gNcSHwiPX9nfTNXVjme9j5DU8y5g\",\n \"reward\": \"3.14466985\",\n \"fees\": \"0.01966985\"\n },\n {\n \"height\": 975851,\n \"hash\": \"0000000000000000000019616694441cd8af0ea40612fea00423994106ff3339\",\n \"time\": \"2026-11-14T22:18:52Z\",\n \"txCount\": 3914,\n \"size\": 1553016,\n \"miner\": \"1K6KoYC69NnafWJ7YgtrpwJxBLiijWqwa6\",\n \"reward\": \"3.17394194\",\n \"fees\": \"0.04894194\"\n }\n ],\n \"next\": 975851\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/latest?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "latest" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Number of blocks to return. 1 to 25 (larger values are capped at 25)", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/latest?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "latest" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Number of blocks to return. 1 to 25 (larger values are capped at 25)", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/latest?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "latest" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Number of blocks to return. 1 to 25 (larger values are capped at 25)", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Block", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/block/get?chain=btc&id=975851&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "975851", "description": "Block height or block hash. Digits for a height; 64 hex characters for a hash (ETH hashes carry 0x).", "disabled": false }, { "key": "page", "value": "1", "description": "Page of the block's transactions, 1-based. 1 or higher", "disabled": true }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] }, "description": "One block by height or hash, with its chain-specific details and a page of its transactions.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/block/get\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/get?chain=btc&id=975851&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "975851", "description": "Block height or block hash. Digits for a height; 64 hex characters for a hash (ETH hashes carry 0x).", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"block\": {\n \"height\": 975851,\n \"hash\": \"0000000000000000000019616694441cd8af0ea40612fea00423994106ff3339\",\n \"time\": \"2026-11-14T22:18:52Z\",\n \"txCount\": 3914,\n \"size\": 1553016,\n \"miner\": \"1K6KoYC69NnafWJ7YgtrpwJxBLiijWqwa6\",\n \"reward\": \"3.17394194\",\n \"fees\": \"0.04894194\",\n \"prevHash\": \"00000000000000000000aab9d0593887d52c5c910227ddbf04a87fb91227800a\",\n \"nextHash\": \"0000000000000000000106d2c49ad20a447077c0ee2a8000a0bf7dca0df81fc5\",\n \"confirmations\": 2,\n \"details\": [\n {\n \"key\": \"difficulty\",\n \"label\": \"Difficulty\",\n \"value\": \"134823837323272.70\",\n \"kind\": \"number\"\n },\n {\n \"key\": \"bits\",\n \"label\": \"Bits\",\n \"value\": \"17021673\",\n \"kind\": \"text\"\n },\n {\n \"key\": \"nonce\",\n \"label\": \"Nonce\",\n \"value\": 2693129303,\n \"kind\": \"number\"\n },\n {\n \"key\": \"merkleRoot\",\n \"label\": \"Merkle root\",\n \"value\": \"c1ecbc059fa5cf6fa14433ef6dc20036d1c6ff9c04b01f19b0af0a4aaca0b8e3\",\n \"kind\": \"hash\"\n },\n {\n \"key\": \"weight\",\n \"label\": \"Weight\",\n \"value\": 3997815,\n \"kind\": \"number\",\n \"unit\": \"WU\"\n },\n {\n \"key\": \"subsidy\",\n \"label\": \"Subsidy\",\n \"value\": \"3.125\",\n \"kind\": \"amount\",\n \"unit\": \"BTC\"\n }\n ]\n },\n \"txs\": [\n {\n \"hash\": \"f1bd58223f137a63659cb2e8f05bf4c362494b41b4586536626c363137d1b6b6\",\n \"block\": 975851,\n \"time\": \"2026-11-14T22:18:52Z\",\n \"status\": \"success\",\n \"from\": null,\n \"to\": \"1K6KoYC69NnafWJ7YgtrpwJxBLiijWqwa6\",\n \"value\": \"3.17394194\",\n \"fee\": null,\n \"method\": \"coinbase\",\n \"inputs\": 1,\n \"outputs\": 7\n },\n {\n \"hash\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"block\": 975851,\n \"time\": \"2026-11-14T22:18:52Z\",\n \"status\": \"success\",\n \"from\": null,\n \"to\": \"37dD2C3QMSSVLPAyQVZo8ZLG53AgUDbcuc\",\n \"value\": \"0.022609\",\n \"fee\": null,\n \"method\": null,\n \"inputs\": 1,\n \"outputs\": 2\n }\n ],\n \"page\": 1,\n \"pages\": 1957,\n \"total\": 3914\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/get?chain=btc&id=975851&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "975851", "description": "Block height or block hash. Digits for a height; 64 hex characters for a hash (ETH hashes carry 0x).", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/get?chain=btc&id=975851&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "975851", "description": "Block height or block hash. Digits for a height; 64 hex characters for a hash (ETH hashes carry 0x).", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Block not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/get?chain=btc&id=975851&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "975851", "description": "Block height or block hash. Digits for a height; 64 hex characters for a hash (ETH hashes carry 0x).", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"This node holds TRON blocks from #86072637 (2026-09-08T17:50:00Z).\",\n \"data\": {\n \"reason\": \"before_history_start\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/get?chain=btc&id=975851&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "975851", "description": "Block height or block hash. Digits for a height; 64 hex characters for a hash (ETH hashes carry 0x).", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/block/get?chain=btc&id=975851&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "block", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "975851", "description": "Block height or block hash. Digits for a height; 64 hex characters for a hash (ETH hashes carry 0x).", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] }, { "name": "Transactions", "description": "Transaction detail, status and mempool (v1), and build, assemble, broadcast, decode, estimate, outspends and signer key (v2). Sign locally with an SDK (recommended) or use hosted signing.", "item": [ { "name": "Transaction", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/get?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] }, "description": "Full detail of one transaction by hash: status, block, amounts and fee, plus inputs and outputs (UTXO chains) or sender, gas, token transfers and logs (ETH and TRON).\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/get\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/get?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"tx\": {\n \"chain\": \"btc\",\n \"hash\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"status\": \"success\",\n \"block\": 975851,\n \"blockHash\": \"0000000000000000000019616694441cd8af0ea40612fea00423994106ff3339\",\n \"time\": \"2026-11-14T22:18:52Z\",\n \"confirmations\": 2,\n \"value\": \"0.022609\",\n \"fee\": \"0.000448\",\n \"utxo\": {\n \"size\": 223,\n \"vsize\": 142,\n \"weight\": 565,\n \"locktime\": 975850,\n \"version\": 2,\n \"rbf\": true,\n \"coinbase\": false,\n \"inputs\": [\n {\n \"txid\": \"15f0189bea2a90b1b7232e96e9d9728ac72187133ce2ad33f2ee464f45cb8fa8\",\n \"vout\": 1,\n \"address\": \"bc1qsxcc56fruvcrwvxpf8ulg572rtt2vn34vtyjlt\",\n \"value\": \"0.023057\",\n \"scriptType\": \"witness_v0_keyhash\",\n \"sequence\": 4294967293,\n \"coinbase\": false\n }\n ],\n \"outputs\": [\n {\n \"n\": 0,\n \"address\": \"37dD2C3QMSSVLPAyQVZo8ZLG53AgUDbcuc\",\n \"value\": \"0.01\",\n \"scriptType\": \"scripthash\",\n \"opReturn\": null,\n \"spent\": false\n },\n {\n \"n\": 1,\n \"address\": \"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\",\n \"value\": \"0.012609\",\n \"scriptType\": \"witness_v0_keyhash\",\n \"opReturn\": null,\n \"spent\": true\n }\n ]\n },\n \"details\": [\n {\n \"key\": \"status\",\n \"label\": \"Status\",\n \"value\": \"Confirmed\",\n \"kind\": \"text\"\n },\n {\n \"key\": \"block\",\n \"label\": \"Block\",\n \"value\": 975851,\n \"kind\": \"block\"\n },\n {\n \"key\": \"inputTotal\",\n \"label\": \"Total input\",\n \"value\": \"0.023057\",\n \"kind\": \"amount\",\n \"unit\": \"BTC\"\n },\n {\n \"key\": \"fee\",\n \"label\": \"Fee\",\n \"value\": \"0.000448\",\n \"kind\": \"amount\",\n \"unit\": \"BTC\"\n },\n {\n \"key\": \"feeRate\",\n \"label\": \"Fee rate\",\n \"value\": \"315.49\",\n \"kind\": \"number\",\n \"unit\": \"sat/vB\",\n \"hint\": \"Fee divided by virtual size.\"\n }\n ]\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/get?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Transaction id must be a 64-character hash.\",\n \"data\": {\n \"param\": \"id\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/get?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Transaction not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/get?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"The node is still indexing old transactions. Try again later.\",\n \"data\": {\n \"reason\": \"tx_index_pending\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/get?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/get?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "get" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Transaction status", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/status?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "status" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] }, "description": "A small, fast status check for one transaction: pending, success or failed, its block, confirmations and time. Built for polling a deposit until it confirms.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/status\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/status?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "status" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"hash\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"status\": \"success\",\n \"block\": 975851,\n \"confirmations\": 2,\n \"time\": \"2026-11-14T22:18:52Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API200 OK (pending)", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/status?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "status" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "OK (pending)", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"hash\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"status\": \"pending\",\n \"block\": null,\n \"confirmations\": 0,\n \"time\": null\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/status?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "status" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Transaction id must be a 64-character hash.\",\n \"data\": {\n \"param\": \"id\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/status?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "status" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Transaction not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/status?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "status" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"The node is still indexing old transactions. Try again later.\",\n \"data\": {\n \"reason\": \"tx_index_pending\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/status?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "status" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/status?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "status" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters, lowercase; ETH hashes carry 0x.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Mempool", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/mempool?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "tx", "mempool" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions to return. 1 to 100", "disabled": false } ] }, "description": "Unconfirmed transactions the node currently sees, newest first, with the mempool size.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/mempool\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/mempool?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "tx", "mempool" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions to return. 1 to 100", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"count\": 68328,\n \"bytes\": 24527873,\n \"items\": [\n {\n \"hash\": \"313da871f52272bbf0fa799af9d46dca0efbc329570dff0a4e30e6dd3f4eb6d4\",\n \"block\": null,\n \"time\": null,\n \"status\": \"pending\",\n \"from\": null,\n \"to\": \"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\",\n \"value\": \"0.000363\",\n \"fee\": null,\n \"method\": null,\n \"inputs\": 1,\n \"outputs\": 2,\n \"firstSeen\": \"2026-11-14T22:23:08Z\"\n },\n {\n \"hash\": \"cf106e2e83ff9f7ac23bef28795db36132c14cde7e0b1c3c070c9378598d6a8d\",\n \"block\": null,\n \"time\": null,\n \"status\": \"pending\",\n \"from\": null,\n \"to\": \"bc1p8ah4ltyv9w2z00ynvulgwxjv8z78mgr5lectl7ey7kacahx8ltrs37wlvd\",\n \"value\": \"0.00195024\",\n \"fee\": null,\n \"method\": null,\n \"inputs\": 3,\n \"outputs\": 6,\n \"firstSeen\": \"2026-11-14T22:23:08Z\"\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/mempool?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "tx", "mempool" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions to return. 1 to 100", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/mempool?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "tx", "mempool" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions to return. 1 to 100", "disabled": false } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"This node has no pending transaction view.\",\n \"data\": {\n \"reason\": \"no_mempool_view\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/mempool?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "tx", "mempool" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions to return. 1 to 100", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/mempool?chain=btc&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "tx", "mempool" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions to return. 1 to 100", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Build a transaction", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Builds an unsigned transaction on any chain and returns the digests to sign. The API supplies UTXOs or nonce and fees; your keys never leave you.\n\nRate class: compute (2 requests per second, burst 10, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/build\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"toSign\": [\n {\n \"index\": 0,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"digest\": \"60f09e680a8d4d7442ec09e2e89181c568f596c6200c6a2d2f4aa15a4a8fc6b1\",\n \"algorithm\": \"ecdsa-secp256k1\",\n \"sighashType\": 1,\n \"scriptType\": \"p2pkh\"\n }\n ],\n \"expiresAt\": \"2026-11-15T00:31:27Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API200 OK (ETH token)", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "OK (ETH token)", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"unsigned\": {\n \"chain\": \"eth\",\n \"format\": \"eth-1559-v1\",\n \"tx\": {\n \"from\": \"0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe\",\n \"to\": \"0xdAC17F958D2ee523a2206206994597C13D831ec7\",\n \"nonce\": 42,\n \"gasLimit\": \"65000\",\n \"maxFeePerGas\": \"18.5\",\n \"maxPriorityFeePerGas\": \"1.2\",\n \"value\": \"0\",\n \"data\": \"0xa9059cbb000000000000000000000000dead00000000000000000000000000000000dead00000000000000000000000000000000000000000000000000000000017d7840\",\n \"chainId\": 1\n }\n },\n \"toSign\": [\n {\n \"index\": 0,\n \"address\": \"0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe\",\n \"digest\": \"9b2c4f0a6d81e3375a40c1be52d9f8a7140c6e3bd52a97f08e1c4d63b0a5f287\",\n \"algorithm\": \"ecdsa-secp256k1-recoverable\"\n }\n ],\n \"expiresAt\": \"2026-11-15T00:50:00Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"This address is not watched yet.\",\n \"data\": {\n \"reason\": \"not_watched\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The inputs do not cover the amount and the fee.\",\n \"data\": {\n \"reason\": \"insufficient_funds\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"An output is below the dust limit.\",\n \"data\": {\n \"reason\": \"dust_output\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/build", "host": [ "{{baseUrl}}" ], "path": [ "tx", "build" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Assemble a signed transaction", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "WARNING: With broadcast set to true this really broadcasts the transaction to the live network. It cannot be undone.\n\nInserts your signatures into an unsigned transaction from tx/build, verifies them, and can broadcast the result in the same call.\n\nRate class: compute (2 requests per second, burst 10, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/assemble\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"signed\": {\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"txid\": \"8235cfafa0ef70d4a5135331c6889a7c15780b7aeb3bc20721571c2a4b51ffa7\"\n },\n \"broadcast\": null\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API200 OK (broadcast)", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}" } }, "status": "OK (broadcast)", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"signed\": {\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"txid\": \"8235cfafa0ef70d4a5135331c6889a7c15780b7aeb3bc20721571c2a4b51ffa7\"\n },\n \"broadcast\": {\n \"txid\": \"8235cfafa0ef70d4a5135331c6889a7c15780b7aeb3bc20721571c2a4b51ffa7\",\n \"accepted\": true,\n \"alreadyKnown\": false\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"A signature does not verify against its digest.\",\n \"data\": {\n \"reason\": \"bad_signature\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API403 Forbidden", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}" } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API403\",\n \"message\": \"The public key does not match the input address.\",\n \"data\": {\n \"reason\": \"key_mismatch\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The node rejected the transaction.\",\n \"data\": {\n \"reason\": \"node_rejected\",\n \"detail\": \"min relay fee not met\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"unsigned is required.\",\n \"data\": {\n \"param\": \"unsigned\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/assemble", "host": [ "{{baseUrl}}" ], "path": [ "tx", "assemble" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"signatures\": [\n {\n \"index\": 0,\n \"signature\": \"3044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb01\",\n \"publicKey\": \"03ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873\"\n }\n ],\n \"broadcast\": false\n}" } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Broadcast a transaction", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "payout-2026-11-14-0001", "description": "Optional. The same key, or the same txid, within 24 hours returns the first result instead of broadcasting twice.", "disabled": true }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}", "options": { "raw": { "language": "json" } } }, "description": "WARNING: Try It! really broadcasts the transaction you paste here to the live network. It cannot be undone.\n\nSends a fully signed transaction to the network through Rarebl's own nodes, with pre-checks and an idempotency key.\n\nRate class: write (6 per minute, burst 3, 300 per day, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/broadcast\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"txid\": \"8235cfafa0ef70d4a5135331c6889a7c15780b7aeb3bc20721571c2a4b51ffa7\",\n \"accepted\": true,\n \"alreadyKnown\": false\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The node rejected the transaction.\",\n \"data\": {\n \"reason\": \"node_rejected\",\n \"detail\": \"min relay fee not met\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"An input is already spent.\",\n \"data\": {\n \"reason\": \"inputs_spent\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The nonce is lower than the pending nonce.\",\n \"data\": {\n \"reason\": \"nonce_too_low\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The chain id is not 1.\",\n \"data\": {\n \"reason\": \"chain_id_mismatch\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The transaction has expired.\",\n \"data\": {\n \"reason\": \"tx_expired\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The transaction is too large.\",\n \"data\": {\n \"reason\": \"tx_too_large\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"hex is required.\",\n \"data\": {\n \"param\": \"hex\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/broadcast", "host": [ "{{baseUrl}}" ], "path": [ "tx", "broadcast" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Decode a transaction", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/decode", "host": [ "{{baseUrl}}" ], "path": [ "tx", "decode" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Decodes a raw transaction (signed or unsigned) into the v1 Tx shape, with status `unsent`, so you can check what you are about to send.\n\nRate class: compute (2 requests per second, burst 10, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/decode\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/decode", "host": [ "{{baseUrl}}" ], "path": [ "tx", "decode" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"tx\": {\n \"chain\": \"dash\",\n \"hash\": \"8235cfafa0ef70d4a5135331c6889a7c15780b7aeb3bc20721571c2a4b51ffa7\",\n \"status\": \"unsent\",\n \"block\": null,\n \"blockHash\": null,\n \"time\": null,\n \"confirmations\": 0,\n \"value\": \"4.23879\",\n \"fee\": \"0.00000226\",\n \"utxo\": {\n \"size\": 225,\n \"vsize\": 225,\n \"weight\": 900,\n \"locktime\": 0,\n \"version\": 2,\n \"rbf\": false,\n \"coinbase\": false,\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"scriptType\": \"pubkeyhash\",\n \"sequence\": 4294967295,\n \"coinbase\": false\n }\n ],\n \"outputs\": [\n {\n \"n\": 0,\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"scriptType\": \"pubkeyhash\",\n \"opReturn\": null,\n \"spent\": null\n },\n {\n \"n\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"scriptType\": \"pubkeyhash\",\n \"opReturn\": null,\n \"spent\": null\n }\n ]\n },\n \"details\": [\n {\n \"key\": \"status\",\n \"label\": \"Status\",\n \"value\": \"Unsent\",\n \"kind\": \"text\"\n }\n ]\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/decode", "host": [ "{{baseUrl}}" ], "path": [ "tx", "decode" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"hex is required.\",\n \"data\": {\n \"param\": \"hex\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/decode", "host": [ "{{baseUrl}}" ], "path": [ "tx", "decode" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/decode", "host": [ "{{baseUrl}}" ], "path": [ "tx", "decode" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\"\n}" } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Estimate a transaction", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Estimates the fee of a transaction without building digests. It takes the same body as tx/build.\n\nRate class: compute (2 requests per second, burst 10, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/estimate\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API200 OK (TRON)", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "OK (TRON)", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"fee\": \"13.9\",\n \"feeSats\": \"13900000\",\n \"energy\": 65000,\n \"bandwidth\": 345\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"This address is not watched yet.\",\n \"data\": {\n \"reason\": \"not_watched\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The inputs do not cover the amount and the fee.\",\n \"data\": {\n \"reason\": \"insufficient_funds\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"An output is below the dust limit.\",\n \"data\": {\n \"reason\": \"dust_output\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/estimate", "host": [ "{{baseUrl}}" ], "path": [ "tx", "estimate" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"dash\",\n \"from\": \"[\\\"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\\\",\\\"amount\\\":\\\"0.01\\\"}]\",\n \"priority\": \"standard\"\n}" } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Output spend status", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/outspends?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "outspends" ], "query": [ { "key": "chain", "value": "btc", "description": "A UTXO chain.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters.", "disabled": false } ] }, "description": "For each output of a UTXO transaction, whether it is spent, by which transaction, and whether the spend is still in the mempool.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/outspends\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/outspends?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "outspends" ], "query": [ { "key": "chain", "value": "btc", "description": "A UTXO chain.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"outputs\": [\n {\n \"n\": 0,\n \"spent\": false,\n \"spentBy\": null,\n \"inMempool\": false\n },\n {\n \"n\": 1,\n \"spent\": true,\n \"spentBy\": \"15f0189bea2a90b1b7232e96e9d9728ac72187133ce2ad33f2ee464f45cb8fa8\",\n \"inMempool\": false\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/outspends?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "outspends" ], "query": [ { "key": "chain", "value": "btc", "description": "A UTXO chain.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Transaction id must be a 64-character hash.\",\n \"data\": {\n \"param\": \"id\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/outspends?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "outspends" ], "query": [ { "key": "chain", "value": "btc", "description": "A UTXO chain.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters.", "disabled": false } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Transaction not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/outspends?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "outspends" ], "query": [ { "key": "chain", "value": "btc", "description": "A UTXO chain.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/outspends?chain=btc&id=9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "host": [ "{{baseUrl}}" ], "path": [ "tx", "outspends" ], "query": [ { "key": "chain", "value": "btc", "description": "A UTXO chain.", "disabled": false }, { "key": "id", "value": "9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db", "description": "The transaction hash. 64 hex characters.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Signer public key", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/signer-key", "host": [ "{{baseUrl}}" ], "path": [ "tx", "signer-key" ], "query": [] }, "description": "The X25519 public key you encrypt private keys to when you use hosted signing. Only the signer process can read what you encrypt to it.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/signer-key\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/signer-key", "host": [ "{{baseUrl}}" ], "path": [ "tx", "signer-key" ], "query": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"kid\": \"k20261115-defd9c\",\n \"alg\": \"X25519\",\n \"publicKey\": \"wL-KbhcrI3WWpG1nv8sNAoiWUVTyw9yMxfn1_jvoxT4\",\n \"expiresAt\": \"2026-12-15T00:12:34.514Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/signer-key", "host": [ "{{baseUrl}}" ], "path": [ "tx", "signer-key" ], "query": [] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/tx/signer-key", "host": [ "{{baseUrl}}" ], "path": [ "tx", "signer-key" ], "query": [] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] }, { "name": "Hosted signing", "description": "Hosted signing sends your private key to Rarebl over TLS; signing locally with an SDK keeps keys on your side and is recommended (https://docs.rarebl.com/guides/sign-locally). The values in this collection are PLACEHOLDERS: do not put a real private key in Postman, which syncs and logs requests.", "item": [ { "name": "Sign a transaction (hosted)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Rarebl-Accept-Risk", "value": "hosted-signing", "description": "Required acknowledgement that you are sending private keys to a hosted signer. The only accepted value is `hosted-signing`; without it the API answers `API403` `risk_not_acknowledged`.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Hosted signing sends your private key to Rarebl over TLS; signing locally with an SDK is recommended. The keys in this collection are placeholders: do not put a real key in Postman.\n\nSends private keys to Rarebl, which signs an unsigned transaction in memory and forgets the keys. It never broadcasts.\n\nRate class: write (6 per minute, burst 3, 300 per day, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/sign\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"signed\": {\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"txid\": \"8235cfafa0ef70d4a5135331c6889a7c15780b7aeb3bc20721571c2a4b51ffa7\"\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API403 Forbidden", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API403\",\n \"message\": \"Hosted signing needs the risk acknowledgement header.\",\n \"data\": {\n \"reason\": \"risk_not_acknowledged\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API403 Forbidden", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API403\",\n \"message\": \"A key does not match the input addresses.\",\n \"data\": {\n \"reason\": \"key_mismatch\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API403 Forbidden", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API403\",\n \"message\": \"The digests are not the ones the envelope names.\",\n \"data\": {\n \"reason\": \"digest_not_bound\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"The envelope could not be read.\",\n \"data\": {\n \"reason\": \"bad_envelope\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"The envelope has expired.\",\n \"data\": {\n \"reason\": \"envelope_expired\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"The envelope was already used.\",\n \"data\": {\n \"reason\": \"envelope_replayed\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"The envelope is for another chain.\",\n \"data\": {\n \"reason\": \"chain_mismatch\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Keys must be sent in the request body.\",\n \"data\": {\n \"reason\": \"plaintext_key_in_query\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"Signing failed.\",\n \"data\": {\n \"reason\": \"bad_signature\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/sign", "host": [ "{{baseUrl}}" ], "path": [ "tx", "sign" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"unsigned\": {\n \"chain\": \"dash\",\n \"format\": \"utxo-v1\",\n \"tx\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a0100000000ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"inputs\": [\n {\n \"txid\": \"7a08e8423f8f4bfe21b0569547b6315f16a94b42d72be5d972a86e0385619f13\",\n \"vout\": 1,\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.23879226\",\n \"valueSats\": \"423879226\",\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\",\n \"scriptType\": \"p2pkh\",\n \"sequence\": 4294967295\n }\n ],\n \"outputs\": [\n {\n \"address\": \"XiM9Afap6UEb5LDkcWrg2YyA28hifkZZKM\",\n \"value\": \"0.01\",\n \"valueSats\": \"1000000\",\n \"change\": false\n },\n {\n \"address\": \"XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF\",\n \"value\": \"4.22879\",\n \"valueSats\": \"422879000\",\n \"change\": true\n }\n ],\n \"fee\": \"0.00000226\",\n \"feeSats\": \"226\",\n \"vsize\": 226,\n \"feeRate\": \"1\"\n },\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Build, sign and send (hosted)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Rarebl-Accept-Risk", "value": "hosted-signing", "description": "Required acknowledgement that you are sending private keys to a hosted signer. The only accepted value is `hosted-signing`; without it the API answers `API403` `risk_not_acknowledged`.", "disabled": false }, { "key": "Idempotency-Key", "value": "payout-2026-11-14-0002", "description": "Optional, as on tx/broadcast.", "disabled": true }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Hosted signing sends your private key to Rarebl over TLS; signing locally with an SDK is recommended. The keys in this collection are placeholders: do not put a real key in Postman.\n\nOne call that builds, signs with the keys you send, and broadcasts.\n\nRate class: write (6 per minute, burst 3, 300 per day, per IP).\n\nDocs: https://docs.rarebl.com/api/tx/send\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"signed\": {\n \"chain\": \"dash\",\n \"hex\": \"0200000001139f6185036ea872d9e52bd7424ba9165f31b6479556b021fe4b8f3f42e8087a010000006a473044022047ac8e878352d3ebbde1c94ce3a10d057c24175747116f8288e5d794d12d482f0220217f36a485cae903c713331d877c1f64677e3622ad4010726870540656fe9dcb012103ad1d8e89212f0b92c74d23bb710c00662ad1470198ac48c43f7d6f93a2a26873ffffffff0240420f00000000001976a91454072845a9ca039a5b585f5fd994d88d38feb31c88ac189f3419000000001976a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac00000000\",\n \"txid\": \"8235cfafa0ef70d4a5135331c6889a7c15780b7aeb3bc20721571c2a4b51ffa7\"\n },\n \"broadcast\": {\n \"txid\": \"8235cfafa0ef70d4a5135331c6889a7c15780b7aeb3bc20721571c2a4b51ffa7\",\n \"accepted\": true,\n \"alreadyKnown\": false\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API403 Forbidden", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API403\",\n \"message\": \"Hosted signing needs the risk acknowledgement header.\",\n \"data\": {\n \"reason\": \"risk_not_acknowledged\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API403 Forbidden", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API403\",\n \"message\": \"A key does not match the input addresses.\",\n \"data\": {\n \"reason\": \"key_mismatch\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API403 Forbidden", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API403\",\n \"message\": \"The outputs are not the ones the envelope names.\",\n \"data\": {\n \"reason\": \"outputs_not_bound\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"The envelope could not be read.\",\n \"data\": {\n \"reason\": \"bad_envelope\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"The envelope has expired.\",\n \"data\": {\n \"reason\": \"envelope_expired\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"The envelope was already used.\",\n \"data\": {\n \"reason\": \"envelope_replayed\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"The envelope is for another chain.\",\n \"data\": {\n \"reason\": \"chain_mismatch\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The inputs do not cover the amount and the fee.\",\n \"data\": {\n \"reason\": \"insufficient_funds\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API422 Unprocessable Entity", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API422\",\n \"message\": \"The node rejected the transaction.\",\n \"data\": {\n \"reason\": \"node_rejected\",\n \"detail\": \"min relay fee not met\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/tx/send", "host": [ "{{baseUrl}}" ], "path": [ "tx", "send" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"from\": \"[\\\"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\\\"]\",\n \"to\": \"[{\\\"address\\\":\\\"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\\\",\\\"amount\\\":\\\"0.0015\\\"}]\",\n \"priority\": \"standard\",\n \"keys\": {\n \"encrypted\": \"BASE64URL_ENVELOPE_FROM_SDK\"\n }\n}" } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "New address and key (hosted)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Rarebl-Accept-Risk", "value": "hosted-signing", "description": "Required acknowledgement that you are sending private keys to a hosted signer. The only accepted value is `hosted-signing`; without it the API answers `API403` `risk_not_acknowledged`.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/new", "host": [ "{{baseUrl}}" ], "path": [ "address", "new" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"type\": \"p2wpkh\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Hosted signing sends your private key to Rarebl over TLS; signing locally with an SDK is recommended. The keys in this collection are placeholders: do not put a real key in Postman.\n\nGenerates a new keypair inside the signer, never stores it, and returns it once. The SDKs can also generate keys locally (`keys.generate`).\n\nRate class: write (6 per minute, burst 3, 300 per day, per IP).\n\nDocs: https://docs.rarebl.com/api/address/new\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/address/new", "host": [ "{{baseUrl}}" ], "path": [ "address", "new" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"type\": \"p2wpkh\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"address\": \"bc1q9n6w0t7m5x3k2a8d4h1j6f0s5g7c3v2b8l4e9z\",\n \"publicKey\": \"02f1a6c3d9e7b04a52c8e1d36f7094ba5c21e8d03f6a97b4c15e2d80a3f6b79c41\",\n \"encryptedPrivateKey\": \"BASE64URL_ENVELOPE_ENCRYPTED_TO_YOUR_X25519_KEY\",\n \"wif\": null\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API403 Forbidden", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/address/new", "host": [ "{{baseUrl}}" ], "path": [ "address", "new" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"type\": \"p2wpkh\"\n}" } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API403\",\n \"message\": \"Hosted signing needs the risk acknowledgement header.\",\n \"data\": {\n \"reason\": \"risk_not_acknowledged\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/address/new", "host": [ "{{baseUrl}}" ], "path": [ "address", "new" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"type\": \"p2wpkh\"\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/address/new", "host": [ "{{baseUrl}}" ], "path": [ "address", "new" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"type\": \"p2wpkh\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/address/new", "host": [ "{{baseUrl}}" ], "path": [ "address", "new" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"type\": \"p2wpkh\"\n}" } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] }, { "name": "Addresses", "description": "Address balance, transactions, token balances (v1), and validate, watch, UTXOs, nonce and resources (v2).", "item": [ { "name": "Address", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/balance?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "host": [ "{{baseUrl}}" ], "path": [ "address", "balance" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to look up. A valid address for the chain. BCH accepts CashAddr (with or without prefix) and legacy.", "disabled": false } ] }, "description": "Balance and summary of an address: validity, type, balance, totals received and sent, transaction count and chain-specific details.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/address/balance\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/balance?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "host": [ "{{baseUrl}}" ], "path": [ "address", "balance" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to look up. A valid address for the chain. BCH accepts CashAddr (with or without prefix) and legacy.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"address\": {\n \"chain\": \"dash\",\n \"address\": \"XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT\",\n \"valid\": true,\n \"type\": \"p2pkh\",\n \"balance\": \"10.0001\",\n \"balanceStatus\": \"exact\",\n \"received\": \"10.0001\",\n \"sent\": \"0\",\n \"txCount\": 1,\n \"tokens\": [],\n \"isContract\": null,\n \"history\": {\n \"available\": true,\n \"reason\": null\n },\n \"details\": [\n {\n \"key\": \"immature\",\n \"label\": \"Immature balance\",\n \"value\": \"0\",\n \"kind\": \"amount\",\n \"unit\": \"DASH\"\n },\n {\n \"key\": \"utxos\",\n \"label\": \"Unspent outputs\",\n \"value\": 1,\n \"kind\": \"number\"\n }\n ]\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API200 OK (index pending)", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/balance?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "host": [ "{{baseUrl}}" ], "path": [ "address", "balance" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to look up. A valid address for the chain. BCH accepts CashAddr (with or without prefix) and legacy.", "disabled": false } ] } }, "status": "OK (index pending)", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"address\": {\n \"chain\": \"btc\",\n \"address\": \"1K6KoYC69NnafWJ7YgtrpwJxBLiijWqwa6\",\n \"valid\": true,\n \"type\": \"p2pkh\",\n \"balance\": null,\n \"balanceStatus\": \"index_pending\",\n \"received\": null,\n \"sent\": null,\n \"txCount\": null,\n \"tokens\": [],\n \"isContract\": null,\n \"history\": {\n \"available\": false,\n \"reason\": \"index_pending\"\n },\n \"details\": []\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/balance?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "host": [ "{{baseUrl}}" ], "path": [ "address", "balance" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to look up. A valid address for the chain. BCH accepts CashAddr (with or without prefix) and legacy.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Invalid BTC address.\",\n \"data\": {\n \"param\": \"address\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/balance?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "host": [ "{{baseUrl}}" ], "path": [ "address", "balance" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to look up. A valid address for the chain. BCH accepts CashAddr (with or without prefix) and legacy.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/balance?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "host": [ "{{baseUrl}}" ], "path": [ "address", "balance" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to look up. A valid address for the chain. BCH accepts CashAddr (with or without prefix) and legacy.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Address transactions", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/transactions?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "address", "transactions" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to list.", "disabled": false }, { "key": "cursor", "value": "", "description": "Opaque cursor from the previous reply's `next`.", "disabled": true }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] }, "description": "The transactions of an address, newest first, with a cursor to page back in time.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/address/transactions\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/transactions?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "address", "transactions" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to list.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"items\": [\n {\n \"hash\": \"8873c69e78499a49913042b743f3a96f28c520f3c0d66db47682f19dd9c43032\",\n \"block\": 2572369,\n \"time\": \"2026-11-14T22:18:18Z\",\n \"status\": \"success\",\n \"from\": \"Xf9atpnTdh2j8mQP2yaJkR9wWSp2vaorzE\",\n \"to\": \"XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT\",\n \"value\": \"50.0005\",\n \"fee\": \"0\",\n \"method\": null,\n \"inputs\": 5,\n \"outputs\": 5\n }\n ],\n \"next\": null\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/transactions?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "address", "transactions" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to list.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Invalid DASH address.\",\n \"data\": {\n \"param\": \"address\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/transactions?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "address", "transactions" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to list.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"Address history needs the history index, which is not built yet for this chain.\",\n \"data\": {\n \"reason\": \"history_unavailable\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/transactions?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "address", "transactions" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to list.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/transactions?chain=btc&address=XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT&limit=2", "host": [ "{{baseUrl}}" ], "path": [ "address", "transactions" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false }, { "key": "address", "value": "XgNx6VFjYhSKPxXcjcPvad61DPSQhdiJDT", "description": "The address to list.", "disabled": false }, { "key": "limit", "value": "2", "description": "Transactions per page. 1 to 100", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Address tokens", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/tokens?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "tokens" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The ETH or TRON address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] }, "description": "Token balances held by an ETH or TRON address: known tokens such as USDT and USDC, plus TRC-10 assets on TRON.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/address/tokens\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/tokens?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "tokens" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The ETH or TRON address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"tokens\": [\n {\n \"contract\": \"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\",\n \"standard\": \"TRC-20\",\n \"symbol\": \"USDT\",\n \"name\": \"Tether USD\",\n \"decimals\": 6,\n \"balance\": \"0.00698\"\n },\n {\n \"contract\": \"1004989\",\n \"standard\": \"TRC-10\",\n \"symbol\": null,\n \"name\": null,\n \"decimals\": null,\n \"balance\": \"1111111\"\n },\n {\n \"contract\": \"1005119\",\n \"standard\": \"TRC-10\",\n \"symbol\": null,\n \"name\": null,\n \"decimals\": null,\n \"balance\": \"8888\"\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/tokens?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "tokens" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The ETH or TRON address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Tokens exist on eth and tron only.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/tokens?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "tokens" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The ETH or TRON address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/tokens?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "tokens" ], "query": [ { "key": "chain", "value": "tron", "description": "The chain to query. Tokens exist on eth and tron only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The ETH or TRON address. ETH: 0x + 40 hex. TRON: base58, starting with T.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Validate an address", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/validate?chain=btc&address=bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "host": [ "{{baseUrl}}" ], "path": [ "address", "validate" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain.", "disabled": false }, { "key": "address", "value": "bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "description": "The address to check.", "disabled": false } ] }, "description": "Checks that an address is well formed for a chain and returns its type and normalized form. For ETH it also tells whether the address is a contract.\n\nRate class: compute (2 requests per second, burst 10, per IP).\n\nDocs: https://docs.rarebl.com/api/address/validate\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/validate?chain=btc&address=bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "host": [ "{{baseUrl}}" ], "path": [ "address", "validate" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain.", "disabled": false }, { "key": "address", "value": "bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "description": "The address to check.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"valid\": true,\n \"type\": \"p2wpkh\",\n \"normalized\": \"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API200 OK (ETH)", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/validate?chain=btc&address=bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "host": [ "{{baseUrl}}" ], "path": [ "address", "validate" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain.", "disabled": false }, { "key": "address", "value": "bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "description": "The address to check.", "disabled": false } ] } }, "status": "OK (ETH)", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"valid\": true,\n \"type\": \"contract\",\n \"normalized\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n \"isContract\": true\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/validate?chain=btc&address=bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "host": [ "{{baseUrl}}" ], "path": [ "address", "validate" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain.", "disabled": false }, { "key": "address", "value": "bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "description": "The address to check.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/validate?chain=btc&address=bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "host": [ "{{baseUrl}}" ], "path": [ "address", "validate" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain.", "disabled": false }, { "key": "address", "value": "bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q", "description": "The address to check.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Watch addresses", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/watch", "host": [ "{{baseUrl}}" ], "path": [ "address", "watch" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"addresses\": [\n \"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\",\n \"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Starts tracking BTC, LTC or BCH addresses (their UTXOs and activity) so that UTXOs, balances and webhooks become exact.\n\nRate class: watch (30 per minute, 2,000 addresses per day, per IP).\n\nDocs: https://docs.rarebl.com/api/address/watch\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/address/watch", "host": [ "{{baseUrl}}" ], "path": [ "address", "watch" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"addresses\": [\n \"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\",\n \"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\"\n ]\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"watches\": [\n {\n \"address\": \"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\",\n \"status\": \"pending\",\n \"since\": \"2026-11-15T01:12:07Z\"\n },\n {\n \"address\": \"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\",\n \"status\": \"active\",\n \"since\": \"2026-11-14T21:03:55Z\"\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/address/watch", "host": [ "{{baseUrl}}" ], "path": [ "address", "watch" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"addresses\": [\n \"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\",\n \"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\"\n ]\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/address/watch", "host": [ "{{baseUrl}}" ], "path": [ "address", "watch" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"chain\": \"btc\",\n \"addresses\": [\n \"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\",\n \"bc1qanfrvw5lunlemvm09dthnxmwknal0fw0q7jfnm\"\n ]\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Address UTXOs", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/utxos?chain=dash&address=XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "host": [ "{{baseUrl}}" ], "path": [ "address", "utxos" ], "query": [ { "key": "chain", "value": "dash", "description": "A UTXO chain.", "disabled": false }, { "key": "address", "value": "XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "description": "The address.", "disabled": false }, { "key": "minConf", "value": "0", "description": "Minimum confirmations.", "disabled": true } ] }, "description": "The unspent outputs and balance of an address, for sweeps and payouts. BTC, LTC and BCH addresses must be watched and active; DASH uses its node index.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/address/utxos\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/utxos?chain=dash&address=XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "host": [ "{{baseUrl}}" ], "path": [ "address", "utxos" ], "query": [ { "key": "chain", "value": "dash", "description": "A UTXO chain.", "disabled": false }, { "key": "address", "value": "XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "description": "The address.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"utxos\": [\n {\n \"txid\": \"1fa1b672aa5ef13127ede15aeef61c5fe3ec8565031cd826f65e6a332baefb9c\",\n \"vout\": 1,\n \"value\": \"4.23877346\",\n \"valueSats\": 423877346,\n \"height\": 2572425,\n \"confirmations\": 2,\n \"scriptPubKey\": \"76a9147fb0a45f00c25ff1cb67753221326c7c420b8b2388ac\"\n }\n ],\n \"balance\": \"4.23877346\",\n \"balanceSats\": 423877346\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API409 Conflict", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/utxos?chain=dash&address=XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "host": [ "{{baseUrl}}" ], "path": [ "address", "utxos" ], "query": [ { "key": "chain", "value": "dash", "description": "A UTXO chain.", "disabled": false }, { "key": "address", "value": "XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "description": "The address.", "disabled": false } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API409\",\n \"message\": \"address is not watched yet: POST address/watch first\",\n \"data\": {\n \"reason\": \"not_watched\",\n \"watch\": {\n \"chain\": \"btc\",\n \"address\": \"bc1q7dszvzdj8lk8dd4ssad94m0t2acunaf48j455q\",\n \"endpoint\": \"address/watch\"\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/utxos?chain=dash&address=XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "host": [ "{{baseUrl}}" ], "path": [ "address", "utxos" ], "query": [ { "key": "chain", "value": "dash", "description": "A UTXO chain.", "disabled": false }, { "key": "address", "value": "XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "description": "The address.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"UTXOs exist on UTXO chains only.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/utxos?chain=dash&address=XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "host": [ "{{baseUrl}}" ], "path": [ "address", "utxos" ], "query": [ { "key": "chain", "value": "dash", "description": "A UTXO chain.", "disabled": false }, { "key": "address", "value": "XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "description": "The address.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/utxos?chain=dash&address=XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "host": [ "{{baseUrl}}" ], "path": [ "address", "utxos" ], "query": [ { "key": "chain", "value": "dash", "description": "A UTXO chain.", "disabled": false }, { "key": "address", "value": "XnL1FvTKqe6aWfB8NrvgbUMuWCEA3dNxfF", "description": "The address.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Address nonce (ETH)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/nonce?chain=eth&address=0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "host": [ "{{baseUrl}}" ], "path": [ "address", "nonce" ], "query": [ { "key": "chain", "value": "eth", "description": "Ethereum only.", "disabled": false }, { "key": "address", "value": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "description": "The ETH address.", "disabled": false } ] }, "description": "The latest and pending transaction count of an Ethereum address, to set the nonce of the next transaction.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/address/nonce\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/nonce?chain=eth&address=0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "host": [ "{{baseUrl}}" ], "path": [ "address", "nonce" ], "query": [ { "key": "chain", "value": "eth", "description": "Ethereum only.", "disabled": false }, { "key": "address", "value": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "description": "The ETH address.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"latest\": 42,\n \"pending\": 42\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/nonce?chain=eth&address=0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "host": [ "{{baseUrl}}" ], "path": [ "address", "nonce" ], "query": [ { "key": "chain", "value": "eth", "description": "Ethereum only.", "disabled": false }, { "key": "address", "value": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "description": "The ETH address.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Invalid ETH address.\",\n \"data\": {\n \"param\": \"address\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/nonce?chain=eth&address=0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "host": [ "{{baseUrl}}" ], "path": [ "address", "nonce" ], "query": [ { "key": "chain", "value": "eth", "description": "Ethereum only.", "disabled": false }, { "key": "address", "value": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "description": "The ETH address.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/nonce?chain=eth&address=0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "host": [ "{{baseUrl}}" ], "path": [ "address", "nonce" ], "query": [ { "key": "chain", "value": "eth", "description": "Ethereum only.", "disabled": false }, { "key": "address", "value": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe", "description": "The ETH address.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Address resources (TRON)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/address/resources?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "resources" ], "query": [ { "key": "chain", "value": "tron", "description": "TRON only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The TRON address.", "disabled": false } ] }, "description": "The energy and bandwidth of a TRON account, and its frozen balances, to know whether a transfer burns TRX.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/address/resources\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/resources?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "resources" ], "query": [ { "key": "chain", "value": "tron", "description": "TRON only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The TRON address.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"energy\": {\n \"limit\": 0,\n \"used\": 0,\n \"available\": 0\n },\n \"bandwidth\": {\n \"free\": 600,\n \"staked\": 0,\n \"used\": 158,\n \"available\": 442\n },\n \"frozen\": []\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/resources?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "resources" ], "query": [ { "key": "chain", "value": "tron", "description": "TRON only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The TRON address.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Invalid TRON address.\",\n \"data\": {\n \"param\": \"address\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/resources?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "resources" ], "query": [ { "key": "chain", "value": "tron", "description": "TRON only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The TRON address.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/address/resources?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "host": [ "{{baseUrl}}" ], "path": [ "address", "resources" ], "query": [ { "key": "chain", "value": "tron", "description": "TRON only.", "disabled": false }, { "key": "address", "value": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL", "description": "The TRON address.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] }, { "name": "Gas and miner fees", "item": [ { "name": "Recommended fees", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/fees/recommended?chain=btc", "host": [ "{{baseUrl}}" ], "path": [ "fees", "recommended" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false } ] }, "description": "Recommended fees for every chain at three speeds — fastest, medium and normal: the miner fee on BTC, LTC, BCH and DASH (sat/vB), the gas price on ETH (Gwei) and the energy price on TRON (sun).\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/fees/recommended\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/fees/recommended?chain=btc", "host": [ "{{baseUrl}}" ], "path": [ "fees", "recommended" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"fees\": {\n \"chain\": \"btc\",\n \"unit\": \"sat/vB\",\n \"slow\": \"0.12\",\n \"standard\": \"0.13\",\n \"fast\": \"1\",\n \"baseFee\": null,\n \"details\": [\n {\n \"key\": \"source\",\n \"label\": \"Source\",\n \"value\": \"Node fee estimator (estimatesmartfee)\",\n \"kind\": \"text\"\n },\n {\n \"key\": \"slow\",\n \"label\": \"Slow target\",\n \"value\": \"24 blocks\",\n \"kind\": \"text\"\n },\n {\n \"key\": \"standard\",\n \"label\": \"Standard target\",\n \"value\": \"6 blocks\",\n \"kind\": \"text\"\n },\n {\n \"key\": \"fast\",\n \"label\": \"Fast target\",\n \"value\": \"2 blocks\",\n \"kind\": \"text\"\n },\n {\n \"key\": \"mempoolMinFee\",\n \"label\": \"Mempool minimum fee\",\n \"value\": \"0.1\",\n \"kind\": \"number\",\n \"unit\": \"sat/vB\"\n }\n ],\n \"updatedAt\": \"2026-11-14T22:39:36Z\"\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API200 OK (TRON)", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/fees/recommended?chain=btc", "host": [ "{{baseUrl}}" ], "path": [ "fees", "recommended" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false } ] } }, "status": "OK (TRON)", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"fees\": {\n \"chain\": \"tron\",\n \"unit\": \"sun\",\n \"slow\": null,\n \"standard\": \"100\",\n \"fast\": null,\n \"baseFee\": null,\n \"details\": [\n {\n \"key\": \"energyPrice\",\n \"label\": \"Energy price\",\n \"value\": \"100\",\n \"kind\": \"number\",\n \"unit\": \"sun\",\n \"hint\": \"Cost of one unit of energy when burning TRX (1 TRX = 1,000,000 sun).\"\n },\n {\n \"key\": \"bandwidthPrice\",\n \"label\": \"Bandwidth price\",\n \"value\": \"1000\",\n \"kind\": \"number\",\n \"unit\": \"sun\",\n \"hint\": \"Cost of one byte of bandwidth when burning TRX.\"\n },\n {\n \"key\": \"newAccountFee\",\n \"label\": \"Account activation fee\",\n \"value\": \"1\",\n \"kind\": \"amount\",\n \"unit\": \"TRX\"\n }\n ],\n \"updatedAt\": \"2026-11-14T22:39:44Z\"\n }\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/fees/recommended?chain=btc", "host": [ "{{baseUrl}}" ], "path": [ "fees", "recommended" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Unknown or missing chain.\",\n \"data\": {\n \"param\": \"chain\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/fees/recommended?chain=btc", "host": [ "{{baseUrl}}" ], "path": [ "fees", "recommended" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/fees/recommended?chain=btc", "host": [ "{{baseUrl}}" ], "path": [ "fees", "recommended" ], "query": [ { "key": "chain", "value": "btc", "description": "The chain to query.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] }, { "name": "Search", "description": "Resolve any height, hash or address.", "item": [ { "name": "Search", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/search/query?q=800000&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "search", "query" ], "query": [ { "key": "q", "value": "800000", "description": "The text to look up: a block height, a transaction or block hash (with or without `0x`), an address (BTC, LTC, BCH, DASH, ETH, TRON), a token symbol, name or contract, a link from another explorer (mempool.space, etherscan, tronscan, blockchair) or a `bitcoin:` or `ethereum:` payment link. Whitespace and quotes are removed. Not empty; at most 256 characters.", "disabled": false }, { "key": "mode", "value": "full", "description": "full (default) checks heights and hashes against the nodes of every candidate chain. fast makes no node call: addresses and names are answered from checksums and the token list, heights and hashes come back with `verified: false`. Use fast for as-you-type suggestions.", "disabled": true }, { "key": "chain", "value": "", "description": "Only return matches on this chain (and ask only its node).", "disabled": true }, { "key": "limit", "value": "20", "description": "The most results to return. 1 to 20. Default 20.", "disabled": false } ] }, "description": "Find out what a pasted string is: a block height, a transaction or block hash, an address in any format, a token name or a contract, or a link from another explorer. Every plausible match comes back ranked, with a confidence and a reason.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/search/query\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/search/query?q=800000&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "search", "query" ], "query": [ { "key": "q", "value": "800000", "description": "The text to look up: a block height, a transaction or block hash (with or without `0x`), an address (BTC, LTC, BCH, DASH, ETH, TRON), a token symbol, name or contract, a link from another explorer (mempool.space, etherscan, tronscan, blockchair) or a `bitcoin:` or `ethereum:` payment link. Whitespace and quotes are removed. Not empty; at most 256 characters.", "disabled": false }, { "key": "limit", "value": "20", "description": "The most results to return. 1 to 20. Default 20.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"results\": [\n {\n \"chain\": \"btc\",\n \"type\": \"block\",\n \"id\": \"800000\",\n \"label\": \"Block 800000 · Bitcoin\",\n \"confidence\": 0.7,\n \"reason\": \"Block 800000 exists on Bitcoin\",\n \"verified\": true,\n \"path\": \"/btc/block/800000\",\n \"rank\": 1\n },\n {\n \"chain\": \"ltc\",\n \"type\": \"block\",\n \"id\": \"800000\",\n \"label\": \"Block 800000 · Litecoin\",\n \"confidence\": 0.7,\n \"reason\": \"Block 800000 exists on Litecoin\",\n \"verified\": true,\n \"path\": \"/ltc/block/800000\",\n \"rank\": 2\n },\n {\n \"chain\": \"bch\",\n \"type\": \"block\",\n \"id\": \"800000\",\n \"label\": \"Block 800000 · Bitcoin Cash\",\n \"confidence\": 0.7,\n \"reason\": \"Block 800000 exists on Bitcoin Cash\",\n \"verified\": true,\n \"path\": \"/bch/block/800000\",\n \"rank\": 3\n },\n {\n \"chain\": \"dash\",\n \"type\": \"block\",\n \"id\": \"800000\",\n \"label\": \"Block 800000 · Dash\",\n \"confidence\": 0.7,\n \"reason\": \"Block 800000 exists on Dash\",\n \"verified\": true,\n \"path\": \"/dash/block/800000\",\n \"rank\": 4\n }\n ],\n \"best\": {\n \"chain\": \"btc\",\n \"type\": \"block\",\n \"id\": \"800000\",\n \"label\": \"Block 800000 · Bitcoin\",\n \"confidence\": 0.7,\n \"reason\": \"Block 800000 exists on Bitcoin\",\n \"verified\": true,\n \"path\": \"/btc/block/800000\",\n \"rank\": 1\n },\n \"ambiguous\": true,\n \"query\": {\n \"input\": \"800000\",\n \"normalized\": \"800000\",\n \"kind\": \"height\",\n \"source\": \"plain\",\n \"chain\": null,\n \"type\": null,\n \"payment\": null\n },\n \"suggestions\": [],\n \"unavailable\": [],\n \"mode\": \"full\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/search/query?q=800000&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "search", "query" ], "query": [ { "key": "q", "value": "800000", "description": "The text to look up: a block height, a transaction or block hash (with or without `0x`), an address (BTC, LTC, BCH, DASH, ETH, TRON), a token symbol, name or contract, a link from another explorer (mempool.space, etherscan, tronscan, blockchair) or a `bitcoin:` or `ethereum:` payment link. Whitespace and quotes are removed. Not empty; at most 256 characters.", "disabled": false }, { "key": "limit", "value": "20", "description": "The most results to return. 1 to 20. Default 20.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Missing parameter: q.\",\n \"data\": {\n \"param\": \"q\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/search/query?q=800000&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "search", "query" ], "query": [ { "key": "q", "value": "800000", "description": "The text to look up: a block height, a transaction or block hash (with or without `0x`), an address (BTC, LTC, BCH, DASH, ETH, TRON), a token symbol, name or contract, a link from another explorer (mempool.space, etherscan, tronscan, blockchair) or a `bitcoin:` or `ethereum:` payment link. Whitespace and quotes are removed. Not empty; at most 256 characters.", "disabled": false }, { "key": "limit", "value": "20", "description": "The most results to return. 1 to 20. Default 20.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API502 Bad Gateway", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/search/query?q=800000&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "search", "query" ], "query": [ { "key": "q", "value": "800000", "description": "The text to look up: a block height, a transaction or block hash (with or without `0x`), an address (BTC, LTC, BCH, DASH, ETH, TRON), a token symbol, name or contract, a link from another explorer (mempool.space, etherscan, tronscan, blockchair) or a `bitcoin:` or `ethereum:` payment link. Whitespace and quotes are removed. Not empty; at most 256 characters.", "disabled": false }, { "key": "limit", "value": "20", "description": "The most results to return. 1 to 20. Default 20.", "disabled": false } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API502\",\n \"message\": \"The node is unavailable or timed out. Please try again.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] }, { "name": "Webhooks", "description": "Create a webhook first: its id and manage token are saved into the collection variables hookId and manageToken and used by the other requests.", "item": [ { "name": "Create a webhook", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});", "const reply = pm.response.json();", "if (reply.status === 1 && reply.data) {", " pm.collectionVariables.set('hookId', reply.data.id);", " pm.collectionVariables.set('manageToken', reply.data.manageToken);", "}" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/create", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "create" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 6\n}", "options": { "raw": { "language": "json" } } }, "description": "Creates a webhook subscription. There are no accounts: the reply carries a management token and a signing secret, both shown once.\n\nRate class: hooks (10 per minute, at most 100 active subscriptions per IP, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/create\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/create", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "create" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 6\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"id\": \"hk_3f9a2c71e0b84d56\",\n \"manageToken\": \"mt_7c1d0e94a2b64f3880c5e1a9d27b6f40\",\n \"signingSecret\": \"whsec_b81f4a9c20de7536a1c4f08e93d2b715\",\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 6,\n \"status\": \"active\",\n \"createdAt\": \"2026-11-15T01:12:07Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/create", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "create" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 6\n}" } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"url must be an https URL on port 443 or 8443.\",\n \"data\": {\n \"param\": \"url\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/create", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "create" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 6\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Get a webhook", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-Hook-Token", "value": "{{manageToken}}", "description": "The `manageToken` returned once by hooks/create. Sent in a header, never in the URL.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/get?id=hk_3f9a2c71e0b84d56", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "get" ], "query": [ { "key": "id", "value": "hk_3f9a2c71e0b84d56", "description": "The webhook subscription id returned by hooks/create.", "disabled": false } ] }, "description": "Reads a subscription. Secrets are not returned again.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/get\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/hooks/get?id=hk_3f9a2c71e0b84d56", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "get" ], "query": [ { "key": "id", "value": "hk_3f9a2c71e0b84d56", "description": "The webhook subscription id returned by hooks/create.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"id\": \"hk_3f9a2c71e0b84d56\",\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 6,\n \"status\": \"active\",\n \"createdAt\": \"2026-11-15T01:12:07Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/hooks/get?id=hk_3f9a2c71e0b84d56", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "get" ], "query": [ { "key": "id", "value": "hk_3f9a2c71e0b84d56", "description": "The webhook subscription id returned by hooks/create.", "disabled": false } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Webhook not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/hooks/get?id=hk_3f9a2c71e0b84d56", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "get" ], "query": [ { "key": "id", "value": "hk_3f9a2c71e0b84d56", "description": "The webhook subscription id returned by hooks/create.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Update a webhook", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Hook-Token", "value": "{{manageToken}}", "description": "The `manageToken` returned once by hooks/create. Sent in a header, never in the URL.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/update", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "update" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Changes fields of a subscription, for example its URL or confirmation threshold.\n\nRate class: hooks (10 per minute, at most 100 active subscriptions per IP, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/update\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/update", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "update" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"id\": \"hk_3f9a2c71e0b84d56\",\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 12,\n \"status\": \"active\",\n \"createdAt\": \"2026-11-15T01:12:07Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/update", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "update" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Webhook not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/update", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "update" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Pause a webhook", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Hook-Token", "value": "{{manageToken}}", "description": "The `manageToken` returned once by hooks/create. Sent in a header, never in the URL.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/pause", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "pause" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Stops deliveries without deleting the subscription.\n\nRate class: hooks (10 per minute, at most 100 active subscriptions per IP, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/pause\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/pause", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "pause" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"id\": \"hk_3f9a2c71e0b84d56\",\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 6,\n \"status\": \"paused\",\n \"createdAt\": \"2026-11-15T01:12:07Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/pause", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "pause" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Webhook not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/pause", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "pause" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Resume a webhook", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Hook-Token", "value": "{{manageToken}}", "description": "The `manageToken` returned once by hooks/create. Sent in a header, never in the URL.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/resume", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "resume" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Restarts deliveries of a paused subscription.\n\nRate class: hooks (10 per minute, at most 100 active subscriptions per IP, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/resume\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/resume", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "resume" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"id\": \"hk_3f9a2c71e0b84d56\",\n \"type\": \"tx.confirmations\",\n \"chain\": \"btc\",\n \"url\": \"https://example.com/hooks/rarebl\",\n \"txid\": \"9dedeb8092d6f026d235e3beb24337ba5657635a38cc949f70c0f28ea15e30db\",\n \"confirmations\": 6,\n \"status\": \"active\",\n \"createdAt\": \"2026-11-15T01:12:07Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/resume", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "resume" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Webhook not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/resume", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "resume" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Delete a webhook", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Hook-Token", "value": "{{manageToken}}", "description": "The `manageToken` returned once by hooks/create. Sent in a header, never in the URL.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/delete", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "delete" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Deletes a subscription permanently.\n\nRate class: hooks (10 per minute, at most 100 active subscriptions per IP, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/delete\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/delete", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "delete" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"id\": \"hk_3f9a2c71e0b84d56\",\n \"deleted\": true\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/delete", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "delete" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Webhook not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/delete", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "delete" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Webhook deliveries", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-Hook-Token", "value": "{{manageToken}}", "description": "The `manageToken` returned once by hooks/create. Sent in a header, never in the URL.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/deliveries?id=hk_3f9a2c71e0b84d56", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "deliveries" ], "query": [ { "key": "id", "value": "hk_3f9a2c71e0b84d56", "description": "The webhook subscription id returned by hooks/create.", "disabled": false } ] }, "description": "The last 100 delivery attempts of a subscription, to debug your endpoint.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/deliveries\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/hooks/deliveries?id=hk_3f9a2c71e0b84d56", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "deliveries" ], "query": [ { "key": "id", "value": "hk_3f9a2c71e0b84d56", "description": "The webhook subscription id returned by hooks/create.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"deliveries\": [\n {\n \"eventId\": \"evt_01hx9k2p4m\",\n \"type\": \"tx.confirmations\",\n \"attempt\": 1,\n \"status\": \"delivered\",\n \"httpStatus\": 200,\n \"durationMs\": 184,\n \"at\": \"2026-11-15T01:18:12Z\"\n },\n {\n \"eventId\": \"evt_01hx9k1c7q\",\n \"type\": \"tx.confirmations\",\n \"attempt\": 2,\n \"status\": \"failed\",\n \"httpStatus\": 503,\n \"durationMs\": 9021,\n \"at\": \"2026-11-15T01:15:03Z\"\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/hooks/deliveries?id=hk_3f9a2c71e0b84d56", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "deliveries" ], "query": [ { "key": "id", "value": "hk_3f9a2c71e0b84d56", "description": "The webhook subscription id returned by hooks/create.", "disabled": false } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Webhook not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/hooks/deliveries?id=hk_3f9a2c71e0b84d56", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "deliveries" ], "query": [ { "key": "id", "value": "hk_3f9a2c71e0b84d56", "description": "The webhook subscription id returned by hooks/create.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Send a test event", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Hook-Token", "value": "{{manageToken}}", "description": "The `manageToken` returned once by hooks/create. Sent in a header, never in the URL.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/test", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "test" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends a signed sample event to your URL so you can test signature verification.\n\nRate class: hooks (10 per minute, at most 100 active subscriptions per IP, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/test\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/test", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "test" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"eventId\": \"evt_test_5d8e2a\",\n \"type\": \"tx.confirmations\",\n \"queued\": true\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/test", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "test" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Webhook not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/test", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "test" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Replay an event", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Hook-Token", "value": "{{manageToken}}", "description": "The `manageToken` returned once by hooks/create. Sent in a header, never in the URL.", "disabled": false }, { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/hooks/replay", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "replay" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\",\n \"eventId\": \"evt_01hx9k1c7q\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Re-sends a past event to your URL.\n\nRate class: hooks (10 per minute, at most 100 active subscriptions per IP, per IP).\n\nDocs: https://docs.rarebl.com/api/hooks/replay\n\nSend a JSON body." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/replay", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "replay" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\",\n \"eventId\": \"evt_01hx9k1c7q\"\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"eventId\": \"evt_01hx9k1c7q\",\n \"queued\": true\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API404 Not Found", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/replay", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "replay" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\",\n \"eventId\": \"evt_01hx9k1c7q\"\n}" } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API404\",\n \"message\": \"Webhook not found.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hooks/replay", "host": [ "{{baseUrl}}" ], "path": [ "hooks", "replay" ], "query": [] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"{{hookId}}\",\n \"eventId\": \"evt_01hx9k1c7q\"\n}" } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] }, { "name": "Market", "description": "Reference prices and FX rates from public feeds. Not Rarebl trading rates.", "item": [ { "name": "Prices", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/market/price?assets=btc,eth"e=usd", "host": [ "{{baseUrl}}" ], "path": [ "market", "price" ], "query": [ { "key": "assets", "value": "btc,eth", "description": "Comma-separated asset symbols.", "disabled": false }, { "key": "quote", "value": "usd", "description": "Quote currency. Besides usd, eur, gbp, ghs and ngn are derived through FX.", "disabled": false } ] }, "description": "Reference prices aggregated from public exchange feeds: the median of fresh sources, outliers more than 2% from the median excluded. Not Rarebl trading rates.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/market/price\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/price?assets=btc,eth"e=usd", "host": [ "{{baseUrl}}" ], "path": [ "market", "price" ], "query": [ { "key": "assets", "value": "btc,eth", "description": "Comma-separated asset symbols.", "disabled": false }, { "key": "quote", "value": "usd", "description": "Quote currency. Besides usd, eur, gbp, ghs and ngn are derived through FX.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"prices\": [\n {\n \"asset\": \"BTC\",\n \"quote\": \"USD\",\n \"price\": \"63421.45\",\n \"change24h\": \"-7.1155\",\n \"sources\": [\n {\n \"id\": \"binance\",\n \"pair\": \"BTC/USD\",\n \"price\": 63449.83,\n \"volume\": 11.75039\n },\n {\n \"id\": \"kraken\",\n \"pair\": \"BTC/USD\",\n \"price\": 63426.4,\n \"volume\": 5752.38744852\n },\n {\n \"id\": \"coinbase\",\n \"pair\": \"BTC/USD\",\n \"price\": 63421.45,\n \"volume\": 16529.56926348\n }\n ],\n \"stale\": false,\n \"updatedAt\": \"2026-11-15T01:00:51.309Z\"\n },\n {\n \"asset\": \"ETH\",\n \"quote\": \"USD\",\n \"price\": \"1741.94\",\n \"change24h\": \"-9.7052\",\n \"sources\": [\n {\n \"id\": \"binance\",\n \"pair\": \"ETH/USD\",\n \"price\": 1742.98,\n \"volume\": 122.249\n },\n {\n \"id\": \"kraken\",\n \"pair\": \"ETH/USD\",\n \"price\": 1740.61,\n \"volume\": 63575.06022326\n },\n {\n \"id\": \"coinbase\",\n \"pair\": \"ETH/USD\",\n \"price\": 1740.96,\n \"volume\": 265726.23468535\n }\n ],\n \"stale\": false,\n \"updatedAt\": \"2026-11-15T01:00:51.437Z\"\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/price?assets=btc,eth"e=usd", "host": [ "{{baseUrl}}" ], "path": [ "market", "price" ], "query": [ { "key": "assets", "value": "btc,eth", "description": "Comma-separated asset symbols.", "disabled": false }, { "key": "quote", "value": "usd", "description": "Quote currency. Besides usd, eur, gbp, ghs and ngn are derived through FX.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Missing parameter: assets.\",\n \"data\": {\n \"param\": \"assets\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/price?assets=btc,eth"e=usd", "host": [ "{{baseUrl}}" ], "path": [ "market", "price" ], "query": [ { "key": "assets", "value": "btc,eth", "description": "Comma-separated asset symbols.", "disabled": false }, { "key": "quote", "value": "usd", "description": "Quote currency. Besides usd, eur, gbp, ghs and ngn are derived through FX.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Tickers", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/market/tickers?asset=btc", "host": [ "{{baseUrl}}" ], "path": [ "market", "tickers" ], "query": [ { "key": "asset", "value": "btc", "description": "An asset symbol.", "disabled": false } ] }, "description": "The individual exchange tickers behind a price.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/market/tickers\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/tickers?asset=btc", "host": [ "{{baseUrl}}" ], "path": [ "market", "tickers" ], "query": [ { "key": "asset", "value": "btc", "description": "An asset symbol.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"tickers\": [\n {\n \"source\": \"binance\",\n \"pair\": \"BTC/USD\",\n \"last\": \"63449.83\",\n \"bid\": \"63392.39\",\n \"ask\": \"63437.98\",\n \"volume24h\": \"11.75039\",\n \"ts\": \"2026-11-15T01:00:51.309Z\"\n },\n {\n \"source\": \"bitfinex\",\n \"pair\": \"BTC/USD\",\n \"last\": \"63499\",\n \"bid\": \"63495\",\n \"ask\": \"63502\",\n \"volume24h\": \"1644.58469326\",\n \"ts\": \"2026-11-15T01:00:45.910Z\"\n },\n {\n \"source\": \"bitstamp\",\n \"pair\": \"BTC/USD\",\n \"last\": \"63413.18\",\n \"bid\": \"63407.27\",\n \"ask\": \"63407.28\",\n \"volume24h\": \"1899.15444542\",\n \"ts\": \"2026-11-15T01:00:44.225Z\"\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/tickers?asset=btc", "host": [ "{{baseUrl}}" ], "path": [ "market", "tickers" ], "query": [ { "key": "asset", "value": "btc", "description": "An asset symbol.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Missing parameter: asset.\",\n \"data\": {\n \"param\": \"asset\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/tickers?asset=btc", "host": [ "{{baseUrl}}" ], "path": [ "market", "tickers" ], "query": [ { "key": "asset", "value": "btc", "description": "An asset symbol.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Price history", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/market/history?asset=btc"e=usd&interval=1h", "host": [ "{{baseUrl}}" ], "path": [ "market", "history" ], "query": [ { "key": "asset", "value": "btc", "description": "An asset symbol.", "disabled": false }, { "key": "quote", "value": "usd", "description": "Quote currency.", "disabled": false }, { "key": "interval", "value": "1h", "description": "Candle size.", "disabled": false }, { "key": "from", "value": "", "description": "Start time (ISO 8601).", "disabled": true }, { "key": "to", "value": "", "description": "End time (ISO 8601).", "disabled": true } ] }, "description": "OHLCV candles for an asset.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/market/history\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/history?asset=btc"e=usd&interval=1h", "host": [ "{{baseUrl}}" ], "path": [ "market", "history" ], "query": [ { "key": "asset", "value": "btc", "description": "An asset symbol.", "disabled": false }, { "key": "quote", "value": "usd", "description": "Quote currency.", "disabled": false }, { "key": "interval", "value": "1h", "description": "Candle size.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"candles\": [\n {\n \"ts\": \"2026-11-14T23:00:00.000Z\",\n \"open\": \"64136.4\",\n \"high\": \"64174.2\",\n \"low\": \"64068.4\",\n \"close\": \"64139.5\",\n \"volume\": null\n },\n {\n \"ts\": \"2026-11-15T00:00:00.000Z\",\n \"open\": \"64123.32\",\n \"high\": \"64469.5\",\n \"low\": \"63430.38\",\n \"close\": \"63478.34\",\n \"volume\": null\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/history?asset=btc"e=usd&interval=1h", "host": [ "{{baseUrl}}" ], "path": [ "market", "history" ], "query": [ { "key": "asset", "value": "btc", "description": "An asset symbol.", "disabled": false }, { "key": "quote", "value": "usd", "description": "Quote currency.", "disabled": false }, { "key": "interval", "value": "1h", "description": "Candle size.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Missing parameter: interval.\",\n \"data\": {\n \"param\": \"interval\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/history?asset=btc"e=usd&interval=1h", "host": [ "{{baseUrl}}" ], "path": [ "market", "history" ], "query": [ { "key": "asset", "value": "btc", "description": "An asset symbol.", "disabled": false }, { "key": "quote", "value": "usd", "description": "Quote currency.", "disabled": false }, { "key": "interval", "value": "1h", "description": "Candle size.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "Assets", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/market/assets", "host": [ "{{baseUrl}}" ], "path": [ "market", "assets" ], "query": [] }, "description": "The assets with prices: symbol, name, chain, token contract and decimals.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/market/assets\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/assets", "host": [ "{{baseUrl}}" ], "path": [ "market", "assets" ], "query": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"assets\": [\n {\n \"symbol\": \"BTC\",\n \"name\": \"Bitcoin\",\n \"chain\": \"btc\",\n \"contract\": null,\n \"decimals\": 8\n },\n {\n \"symbol\": \"ETH\",\n \"name\": \"Ether\",\n \"chain\": \"eth\",\n \"contract\": null,\n \"decimals\": 18\n },\n {\n \"symbol\": \"LTC\",\n \"name\": \"Litecoin\",\n \"chain\": \"ltc\",\n \"contract\": null,\n \"decimals\": 8\n },\n {\n \"symbol\": \"TRX\",\n \"name\": \"TRON\",\n \"chain\": \"tron\",\n \"contract\": null,\n \"decimals\": 6\n },\n {\n \"symbol\": \"USDC\",\n \"name\": \"USD Coin (ERC-20)\",\n \"chain\": \"eth\",\n \"contract\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n \"decimals\": 6\n },\n {\n \"symbol\": \"USDT\",\n \"name\": \"Tether USD (ERC-20)\",\n \"chain\": \"eth\",\n \"contract\": \"0xdAC17F958D2ee523a2206206994597C13D831ec7\",\n \"decimals\": 6\n },\n {\n \"symbol\": \"USDT-TRON\",\n \"name\": \"Tether USD (TRC-20)\",\n \"chain\": \"tron\",\n \"contract\": \"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\",\n \"decimals\": 6\n }\n ]\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/assets", "host": [ "{{baseUrl}}" ], "path": [ "market", "assets" ], "query": [] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] }, { "name": "FX rates", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Replies with the Rarebl envelope', function () {", " const body = pm.response.json();", " pm.expect(body).to.have.all.keys('status', 'code', 'message', 'data', 'go', 'meta');", "});" ] } } ], "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{apiKey}}", "description": "Reserved. Ignored: the API is keyless.", "disabled": true } ], "url": { "raw": "{{baseUrl}}/market/fx?base=usd"es=ghs,ngn", "host": [ "{{baseUrl}}" ], "path": [ "market", "fx" ], "query": [ { "key": "base", "value": "usd", "description": "Base currency.", "disabled": false }, { "key": "quotes", "value": "ghs,ngn", "description": "Comma-separated quote currencies.", "disabled": false } ] }, "description": "Foreign-exchange reference rates, for example usd to ghs and ngn.\n\nRate class: read (5 requests per second, burst 20, per IP).\n\nDocs: https://docs.rarebl.com/api/market/fx\n\nQuery parameters (v1 reads also accept a JSON POST with the same parameters)." }, "response": [ { "name": "API200 OK", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/fx?base=usd"es=ghs,ngn", "host": [ "{{baseUrl}}" ], "path": [ "market", "fx" ], "query": [ { "key": "base", "value": "usd", "description": "Base currency.", "disabled": false }, { "key": "quotes", "value": "ghs,ngn", "description": "Comma-separated quote currencies.", "disabled": false } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 1,\n \"code\": \"API200\",\n \"message\": \"success\",\n \"data\": {\n \"rates\": {\n \"GHS\": \"11.747527\",\n \"NGN\": \"1352.072165\"\n },\n \"source\": \"er-api\",\n \"updatedAt\": \"2026-11-15T00:37:02.017Z\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API400 Bad Request", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/fx?base=usd"es=ghs,ngn", "host": [ "{{baseUrl}}" ], "path": [ "market", "fx" ], "query": [ { "key": "base", "value": "usd", "description": "Base currency.", "disabled": false }, { "key": "quotes", "value": "ghs,ngn", "description": "Comma-separated quote currencies.", "disabled": false } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API400\",\n \"message\": \"Missing parameter: quotes.\",\n \"data\": {\n \"param\": \"quotes\"\n },\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" }, { "name": "API429 Too Many Requests", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/market/fx?base=usd"es=ghs,ngn", "host": [ "{{baseUrl}}" ], "path": [ "market", "fx" ], "query": [ { "key": "base", "value": "usd", "description": "Base currency.", "disabled": false }, { "key": "quotes", "value": "ghs,ngn", "description": "Comma-separated quote currencies.", "disabled": false } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 0,\n \"code\": \"API429\",\n \"message\": \"Too many requests. Please retry shortly.\",\n \"data\": null,\n \"go\": null,\n \"meta\": {\n \"requestid\": \"0123456789abcdef\",\n \"notices\": []\n }\n}" } ] } ] } ] }