Freelance Workspace

Etherdrops API (Beta)

Wallets

Get wallets

Edit wallets

Endpoint to add wallets to track. All events related to these wallets will be sent to the webhook endpoint
You can add up to 100 wallets per request

Create wallets

Delete wallets

Etherdrops API

Webhook

This is an example of a webhook endpoint that you should implement on your side

Test webhook

EtherDrops API

Host

Sandbox

error

code

message

details

timestamp

Request Id (will help to find your request faster)

requestId

Error Example

Indicated that request handled successfully

success

result

Success Example

<p class="slate-p" placeholder="Type / for widgets"></p><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">EtherDrops API is currently on Beta and supports only wallets features</p></div></div><h2 class="slate-h2">How To Use</h2><p class="slate-p" placeholder="Type / for widgets">Create an <strong class="slate-bold">app</strong> using <a href="https://t.me/fomo" target="_blank">Etherdrops Bot</a> and obtain <strong class="slate-bold">API Key </strong>and setup <strong class="slate-bold">Webhook</strong>.</p><h3 class="slate-h3">Authentication</h3><p class="slate-p" placeholder="Type / for widgets">The Etherdrops API uses Api Keys from  <em class="slate-italic">Authorization</em> header to authenticate requests. </p><p class="slate-p" placeholder="Type / for widgets"><span style="color:#4C1130;font-size:14px" class="slate-color">All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail with </span><code style="font-size:14px" class="slate-code">401 Unauthorized</code> error.</p><h3 class="slate-h3">Rate Limit</h3><p class="slate-p" placeholder="Type / for widgets">API requests has limit 10 requests per second.</p><h3 class="slate-h3">Response</h3><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail with 

API requests has limit 10 requests per second.

<h2 class="slate-h2">Introduction</h2><p class="slate-p" placeholder="Type / for widgets">Webhooks let you subscribe to events happening in your entities and do required action on your side.</p><h2 class="slate-h2">Setup</h2><p class="slate-p" placeholder="Type / for widgets">To use webhooks you need to do next steps:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Implement <code class="slate-code">POST</code> endpoint with public access which will handle events;</div></li><li class="slate-li"><div style="position:relative">Setup webhook (<code class="slate-code">url</code> and <code class="slate-code">secret</code>) in your <a href="https://t.me/fomo" target="_blank">Etherdrops Bot</a> profile inside <code class="slate-code">API</code>section;</div></li></ul><h2 class="slate-h2">Signature</h2><p class="slate-p" placeholder="Type / for widgets">Each request to your webhook endpoint signed using your <code class="slate-code">secret</code> and send calculated hash in <code class="slate-code">X-Sign</code> header.</p><p class="slate-p" placeholder="Type / for widgets">In your code that handles webhook events, you should calculate a hash using your secret token. Then, compare the hash that Etherdrops sent with the expected hash that you calculated, and ensure that they match.</p><p class="slate-p" placeholder="Type / for widgets">Ethedrops uses an HMAC hex digest to compute the hash.</p><p class="slate-p" placeholder="Type / for widgets">Example to calculate hash in go:</p><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-114-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="language-go keep-markup drop-tokens"><div class="slate-code_line">mac := hmac.New(sha256.New, []byte(Secret))</div><div class="slate-code_line">mac.Write(jsonString)</div><div class="slate-code_line">signature := mac.Sum(nil)</div><div class="slate-code_line">hash = hex.EncodeToString(signature)</div></code></pre><h2 class="slate-h2">Webhook Endpoint
</h2><p class="slate-p" placeholder="Type / for widgets">Your Endpoint should return <code class="slate-code">200</code>  status with any response body.</p><p class="slate-p" placeholder="Type / for widgets"></p>

Sections