{"info":{"_postman_id":"46b7acdd-c7c1-07f3-edd6-364ce791b034","name":"Etheroscope API","description":"

The Etheroscope API provides information about Ethereum contracts and their variables.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"408989","collectionId":"46b7acdd-c7c1-07f3-edd6-364ce791b034","publishedId":"7EEfE5N","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2017-11-29T22:41:07.000Z"},"item":[{"name":"Contract Metadata","id":"edd0f93a-ccf4-b0d5-ae5c-c696ed3588a1","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"production-api.etheroscope.info/contracts/{contract-address}","description":"

The contract metadata endpoint is used to get contract ABI our system stores for a contract address as well as a list of \"variables\" from this ABI.

\n

These variables are defined to be functions that take no parameters and return an integer value.

\n","urlObject":{"path":["contracts","{contract-address}"],"host":["production-api","etheroscope","info"],"query":[],"variable":[]}},"response":[{"id":"8e5798c0-2200-21c3-8b3b-73b12c09efd6","name":"Alice.si smart contract","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"production-api.etheroscope.info/contracts/0xBd897c8885b40d014Fb7941B3043B21adcC9ca1C"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"173","name":"Content-Length","description":""},{"key":"Content-Type","value":"text/html","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 29 Nov 2017 15:30:58 GMT","name":"Date","description":""},{"key":"Server","value":"nginx/1.12.1","name":"Server","description":""}],"cookie":[],"responseTime":"155","body":"{\n \"variables\": [\n \"total\"\n ],\n \"abi\": [\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [\n {\n \"type\": \"string\",\n \"name\": \"\"\n }\n ],\n \"name\": \"name\",\n \"inputs\": [],\n \"constant\": true\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"setBeneficiary\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"_beneficiaryAddress\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"notify\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"_from\"\n },\n {\n \"type\": \"uint256\",\n \"name\": \"_value\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"unlockOutcome\",\n \"inputs\": [\n {\n \"type\": \"string\",\n \"name\": \"_name\"\n },\n {\n \"type\": \"uint256\",\n \"name\": \"_value\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [\n {\n \"type\": \"uint256\",\n \"name\": \"\"\n }\n ],\n \"name\": \"total\",\n \"inputs\": [],\n \"constant\": true\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [\n {\n \"type\": \"address\",\n \"name\": \"\"\n }\n ],\n \"name\": \"judgeAddress\",\n \"inputs\": [],\n \"constant\": true\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"setImpactRegistry\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"impactRegistryAddress\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"payBack\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"account\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"escape\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"escapeAddress\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"setContractProvider\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"_contractProvider\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"setJudge\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"_judgeAddress\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [\n {\n \"type\": \"address\",\n \"name\": \"\"\n }\n ],\n \"name\": \"CONTRACT_PROVIDER_ADDRESS\",\n \"inputs\": [],\n \"constant\": true\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [],\n \"name\": \"fund\",\n \"inputs\": [\n {\n \"type\": \"uint256\",\n \"name\": \"_value\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [\n {\n \"type\": \"address\",\n \"name\": \"\"\n }\n ],\n \"name\": \"IMPACT_REGISTRY_ADDRESS\",\n \"inputs\": [],\n \"constant\": true\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [\n {\n \"type\": \"address\",\n \"name\": \"\"\n }\n ],\n \"name\": \"beneficiaryAddress\",\n \"inputs\": [],\n \"constant\": true\n },\n {\n \"type\": \"function\",\n \"payable\": false,\n \"outputs\": [\n {\n \"type\": \"uint256\",\n \"name\": \"\"\n }\n ],\n \"name\": \"getBalance\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"donor\"\n }\n ],\n \"constant\": false\n },\n {\n \"type\": \"constructor\",\n \"payable\": false,\n \"inputs\": [\n {\n \"type\": \"string\",\n \"name\": \"_name\"\n }\n ]\n },\n {\n \"type\": \"fallback\",\n \"payable\": false\n },\n {\n \"type\": \"event\",\n \"name\": \"OutcomeEvent\",\n \"inputs\": [\n {\n \"type\": \"string\",\n \"name\": \"name\",\n \"indexed\": false\n },\n {\n \"type\": \"uint256\",\n \"name\": \"value\",\n \"indexed\": false\n }\n ],\n \"anonymous\": false\n },\n {\n \"type\": \"event\",\n \"name\": \"DonationEvent\",\n \"inputs\": [\n {\n \"type\": \"address\",\n \"name\": \"from\",\n \"indexed\": true\n },\n {\n \"type\": \"uint256\",\n \"name\": \"value\",\n \"indexed\": false\n }\n ],\n \"anonymous\": false\n }\n ]\n}"},{"id":"966c2165-2ed3-7024-fef9-7c1855ae7be1","name":"Non-smart contract","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"production-api.etheroscope.info/contracts/non-smart-contract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":"0","body":"{\"variables\":[],\"error\":\"NO_ABI_ETHERSCAN\",\"abi\":[]}"}],"_postman_id":"edd0f93a-ccf4-b0d5-ae5c-c696ed3588a1"},{"name":"Variable history","id":"5e8d0179-fdfd-3ff7-e752-31d6709582e4","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"production-api.etheroscope.info/contracts/{contract-address}/history/{variable}","description":"

Retreives all historic values a variable in a contract.

\n

There are 3 statuses for this resource:

\n
    \n
  1. 404 Not found This variable has not been requested yet. You should send a POST request to this URL. (see below)
    2. \n
  2. 503 Service unavailable The history for the variable is being generated. The response body will provide some metadata about the progress.
    3. \n
  3. 200 OK The variable history has been generated and is in the response body.
    4. \n
\n","urlObject":{"path":["contracts","{contract-address}","history","{variable}"],"host":["production-api","etheroscope","info"],"query":[],"variable":[]}},"response":[{"id":"0850f75c-c496-855a-cadc-946e47e29b80","name":"Alice.si donations contract total variable - requested, request complete","originalRequest":{"header":[]},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"22","name":"Content-Length","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 29 Nov 2017 18:14:35 GMT","name":"Date","description":""},{"key":"Server","value":"nginx/1.12.1","name":"Server","description":""},{"key":"access-control-allow-credentials","value":"true","name":"access-control-allow-credentials","description":""},{"key":"access-control-allow-origin","value":"*","name":"access-control-allow-origin","description":""},{"key":"access-control-expose-headers","value":"","name":"access-control-expose-headers","description":""},{"key":"cache-control","value":"max-age=0, private, must-revalidate","name":"cache-control","description":""},{"key":"x-request-id","value":"3ja0ma2ca447n0n3omsp9v774m1cikf3","name":"x-request-id","description":""}],"cookie":[],"responseTime":"790","body":"{\r\n \"data\": [\r\n {\r\n \"value\": \"271700\",\r\n \"time\": 1507013800\r\n },\r\n {\r\n \"value\": \"271700\",\r\n \"time\": 1507013800\r\n },\r\n {\r\n \"value\": \"271600\",\r\n \"time\": 1506959614\r\n },\r\n {\r\n \"value\": \"271500\",\r\n \"time\": 1505917268\r\n },\r\n {\r\n \"value\": \"270500\",\r\n \"time\": 1505894389\r\n },\r\n {\r\n \"value\": \"269500\",\r\n \"time\": 1505847353\r\n },\r\n {\r\n \"value\": \"267500\",\r\n \"time\": 1505827890\r\n }\r\n ]\r\n}"},{"id":"7167c3b8-6227-45b2-91db-2bb79595012a","name":"Non-smart contract with fake variable","originalRequest":{"header":[]},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"173","name":"Content-Length","description":""},{"key":"Content-Type","value":"text/html","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 29 Nov 2017 15:36:25 GMT","name":"Date","description":""},{"key":"Server","value":"nginx/1.12.1","name":"Server","description":""}],"cookie":[],"responseTime":"304","body":"{\n \"error\": \"Not Found\"\n}"},{"id":"dc5805b8-3719-7da3-8ba5-3477cf093973","name":"Alice.si donations contract total variable - not requested yet","originalRequest":{"header":[]},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"173","name":"Content-Length","description":""},{"key":"Content-Type","value":"text/html","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 29 Nov 2017 15:30:58 GMT","name":"Date","description":""},{"key":"Server","value":"nginx/1.12.1","name":"Server","description":""}],"cookie":[],"responseTime":"155","body":"{\n \"error\": \"Not Found\"\n}"},{"id":"ee1249b6-67a1-7d58-128e-cb5c60699557","name":"Alice.si donations contract total variable - requested, in progress","originalRequest":{"header":[]},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"22","name":"Content-Length","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 29 Nov 2017 18:14:35 GMT","name":"Date","description":""},{"key":"Server","value":"nginx/1.12.1","name":"Server","description":""},{"key":"access-control-allow-credentials","value":"true","name":"access-control-allow-credentials","description":""},{"key":"access-control-allow-origin","value":"*","name":"access-control-allow-origin","description":""},{"key":"access-control-expose-headers","value":"","name":"access-control-expose-headers","description":""},{"key":"cache-control","value":"max-age=0, private, must-revalidate","name":"cache-control","description":""},{"key":"x-request-id","value":"3ja0ma2ca447n0n3omsp9v774m1cikf3","name":"x-request-id","description":""}],"cookie":[],"responseTime":"790","body":"{\r\n \"status\": \"fetching\",\r\n \"data\": 0.10058970715821504\r\n}"}],"_postman_id":"5e8d0179-fdfd-3ff7-e752-31d6709582e4"},{"name":"Request variable history","id":"c2fcbb81-d8b5-1d03-870d-3f87e8b79381","request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[]},"url":"production-api.etheroscope.info/contracts/{contract-address}/history/{variable}","description":"

POSTing to this endpoint requests the history for :variable in :contract-address. See above for more details about the process.

\n","urlObject":{"path":["contracts","{contract-address}","history","{variable}"],"host":["production-api","etheroscope","info"],"query":[],"variable":[]}},"response":[{"id":"00b0876f-c987-f6aa-463b-b58b0142642a","name":"Requesting an already requested variable history","originalRequest":{"header":[]},"status":"No Content","code":204,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"21","name":"Content-Length","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 29 Nov 2017 17:29:04 GMT","name":"Date","description":""},{"key":"Server","value":"nginx/1.12.1","name":"Server","description":""},{"key":"access-control-allow-credentials","value":"true","name":"access-control-allow-credentials","description":""},{"key":"access-control-allow-origin","value":"*","name":"access-control-allow-origin","description":""},{"key":"access-control-expose-headers","value":"","name":"access-control-expose-headers","description":""},{"key":"cache-control","value":"max-age=0, private, must-revalidate","name":"cache-control","description":""},{"key":"x-request-id","value":"b6562o438n28imjpj817hrtk8c9u6gmm","name":"x-request-id","description":""}],"cookie":[],"responseTime":"151","body":"{\n \"result\": \"Request Already Submitted\"\n}"},{"id":"584107df-e10b-cef6-d945-b2d7a54b839e","name":"Requesting a not-yet-requested variable","originalRequest":{"header":[]},"status":"Created","code":201,"_postman_previewlanguage":"html","header":[{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"173","name":"Content-Length","description":""},{"key":"Content-Type","value":"text/html","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 29 Nov 2017 15:30:58 GMT","name":"Date","description":""},{"key":"Server","value":"nginx/1.12.1","name":"Server","description":""}],"cookie":[],"responseTime":"155","body":"{\n \"result\": \"Request Accepted\"\n}"},{"id":"5e21c8a4-be2f-75e3-7166-129f16c5cdbb","name":"Requesting history for a non-smart contract","originalRequest":{"header":[]},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"173","name":"Content-Length","description":""},{"key":"Content-Type","value":"text/html","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 29 Nov 2017 15:36:25 GMT","name":"Date","description":""},{"key":"Server","value":"nginx/1.12.1","name":"Server","description":""}],"cookie":[],"responseTime":"304","body":"{\n \"error\": \"NO_ABI_ETHERSCAN\"\n}"}],"_postman_id":"c2fcbb81-d8b5-1d03-870d-3f87e8b79381"}]}