API explorerChangelog
API explorer
Changelog

Theme switcher

Etherdrops API (Beta)

EtherDrops API is currently on Beta and supports only wallets features

How To Use

Create an app using Etherdrops Bot and obtain API Key and setup Webhook.

Authentication

The Etherdrops API uses Api Keys from Authorization header to authenticate requests.

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

Rate Limit

API requests has limit 10 requests per second.

Response

Error Example

errorboolean

Indicates that error happened

codestring
messagestring

Error description

detailsstring

Some useful details about erro

timestampnumber

Timestamp of request

requestIdstring

Request Id (will help to find your request faster)

Success Example

successboolean

Indicated that request handled successfully

resultobject

Response data

timestampnumber

Timestamp of request

requestIdstring

Request Id

Was this section helpful?

What made this section unhelpful for you?

Base URL

Host:

https://api.ethedrops.dropstab.com/

Language Box

1 2 3 4 5 6 7 8 { "error": true, "code": "auth_error", "message": "Invalid or missing API key", "details": null, "timestamp": 1709801124889, "requestId": "49f9b4ea-5f4f-4382-8d0a-8241cee655b4" }
Was this section helpful?

What made this section unhelpful for you?

Wallets

Was this section helpful?

What made this section unhelpful for you?

Get wallets

Endpoints to get wallets added to track

Query Parameters

limitinteger

Limit of the result should be between 1 and 1000

Minimum
1
Maximum
1000
offsetinteger

Offset of the result

Response

200
Object
OK

Response Attributes

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

resultobject

Result of the operation

Show child attributes

successboolean

Success flag

timestampinteger

Timestamp of the operation

400
Object
Bad Request

Response Attributes

codestring

Error code

Enum values:
invalid_requestvalidation_errorinternal_errorauth_errortoo_match_entities_errorsubscription_limits_reached
detailsstring

Error details

errorboolean

Error flag

messagestring

Error message

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

timestampinteger

Timestamp of the error

401
Object
Unauthorized

Response Attributes

codestring

Error code

Enum values:
invalid_requestvalidation_errorinternal_errorauth_errortoo_match_entities_errorsubscription_limits_reached
detailsstring

Error details

errorboolean

Error flag

messagestring

Error message

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

timestampinteger

Timestamp of the error

Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/wallets?limit=&offset=

Select
1 curl --location 'https://api.ethedrops.dropstab.com/api/v1/wallets' \

Response

{
  "requestId": "",
  "result": {
    "total": 10,
    "wallets": {}
  },
  "success": false,
  "timestamp": null
}
Was this section helpful?

What made this section unhelpful for you?

Edit wallets

Endpoint to edit wallets

Body Parameters

autoLabelboolean

if true we will auto label the wallets which are not labeled. We have a large database of wallet addresses names

Default value
false
walletsarray Required

wallets to edit

Show child attributes

Response

200
Object
OK

Response Attributes

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

resultarray

Result of the operation

Show child attributes

successboolean

Success flag

timestampinteger

Timestamp of the operation

400
Object
Bad Request

Response Attributes

codestring

Error code

Enum values:
invalid_requestvalidation_errorinternal_errorauth_errortoo_match_entities_errorsubscription_limits_reached
detailsstring

Error details

errorboolean

Error flag

messagestring

Error message

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

timestampinteger

Timestamp of the error

401
Object
Unauthorized

Response Attributes

codestring

Error code

Enum values:
invalid_requestvalidation_errorinternal_errorauth_errortoo_match_entities_errorsubscription_limits_reached
detailsstring

Error details

errorboolean

Error flag

messagestring

Error message

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

timestampinteger

Timestamp of the error

Was this section helpful?

What made this section unhelpful for you?

PUT

/api/v1/wallets

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 curl --location --request PUT 'https://api.ethedrops.dropstab.com/api/v1/wallets' \ --data '{ "autoLabel": true, "wallets": [ { "address": "0x0000000000000000000000000000000000000000", "direction": "All", "events": [ "", "TokenTransfer", "NFT" ], "excludedContracts": [ "" ], "id": "", "includedContracts": [ "" ], "label": "My Wallet", "networks": [ "", "ETH", "BSC" ], "txValue": "" } ] }'

Response

{
  "requestId": "",
  "result": [
    {
      "address": "0x0000000000000000000000000000000000000000",
      "direction": "All",
      "events": [
        "",
        "TokenTransfer",
        "NFT"
      ],
      "excludedContracts": [
        "",
        "0x0000000000000000000000000000000000000001"
      ],
      "id": "60f3b3b3b3b3b3b3b3b3b3b3",
      "includedContracts": [
        "",
        "0x0000000000000000000000000000000000000001"
      ],
      "label": "My Wallet",
      "networks": [
        "",
        "ETH",
        "BSC",
        "POLYGON"
      ],
      "txValue": {
        "lessOrEquals": {
          "value": null
        },
        "lessOrMore": {
          "less": null,
          "more": null
        },
        "moreOrEquals": {
          "value": 100
        },
        "range": {
          "from": null,
          "to": null
        }
      }
    }
  ],
  "success": false,
  "timestamp": null
}
Was this section helpful?

What made this section unhelpful for you?

Create 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

Body Parameters

autoLabelboolean

if true we will auto label the wallets which are not labeled. We have a large database of wallet addresses names

Default value
false
walletsarray Required

wallets to create

Show child attributes

Response

200
Object
OK

Response Attributes

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

resultarray

Result of the operation

Show child attributes

successboolean

Success flag

timestampinteger

Timestamp of the operation

400
Object
Bad Request

Response Attributes

codestring

Error code

Enum values:
invalid_requestvalidation_errorinternal_errorauth_errortoo_match_entities_errorsubscription_limits_reached
detailsstring

Error details

errorboolean

Error flag

messagestring

Error message

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

timestampinteger

Timestamp of the error

401
Object
Unauthorized

Response Attributes

codestring

Error code

Enum values:
invalid_requestvalidation_errorinternal_errorauth_errortoo_match_entities_errorsubscription_limits_reached
detailsstring

Error details

errorboolean

Error flag

messagestring

Error message

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

timestampinteger

Timestamp of the error

Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/wallets

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 curl --location 'https://api.ethedrops.dropstab.com/api/v1/wallets' \ --data '{ "autoLabel": true, "wallets": [ { "address": "0x0000000000000000000000000000000000000000", "direction": "All", "events": [ "", "TokenTransfer", "NFT" ], "excludedContracts": [ "" ], "includedContracts": [ "" ], "label": "My Wallet", "networks": [ "", "ETH", "BSC" ], "txValue": "" } ] }'

Response

{
  "requestId": "",
  "result": [
    {
      "address": "0x0000000000000000000000000000000000000000",
      "direction": "All",
      "events": [
        "",
        "TokenTransfer",
        "NFT"
      ],
      "excludedContracts": [
        "",
        "0x0000000000000000000000000000000000000001"
      ],
      "id": "60f3b3b3b3b3b3b3b3b3b3b3",
      "includedContracts": [
        "",
        "0x0000000000000000000000000000000000000001"
      ],
      "label": "My Wallet",
      "networks": [
        "",
        "ETH",
        "BSC",
        "POLYGON"
      ],
      "txValue": {
        "lessOrEquals": {
          "value": null
        },
        "lessOrMore": {
          "less": null,
          "more": null
        },
        "moreOrEquals": {
          "value": 100
        },
        "range": {
          "from": null,
          "to": null
        }
      }
    }
  ],
  "success": false,
  "timestamp": null
}
Was this section helpful?

What made this section unhelpful for you?

Delete wallets

Endpoint to delete wallets

Body Parameters

walletsarray

wallet ids to delete

Show child attributes

Response

200
Object
OK

Response Attributes

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

resultboolean

Result of the operation

successboolean

Success flag

timestampinteger

Timestamp of the operation

400
Object
Bad Request

Response Attributes

codestring

Error code

Enum values:
invalid_requestvalidation_errorinternal_errorauth_errortoo_match_entities_errorsubscription_limits_reached
detailsstring

Error details

errorboolean

Error flag

messagestring

Error message

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

timestampinteger

Timestamp of the error

401
Object
Unauthorized

Response Attributes

codestring

Error code

Enum values:
invalid_requestvalidation_errorinternal_errorauth_errortoo_match_entities_errorsubscription_limits_reached
detailsstring

Error details

errorboolean

Error flag

messagestring

Error message

requestIdstring

RequestId of the operation (useful if error occurs and you need to help from support)

timestampinteger

Timestamp of the error

Was this section helpful?

What made this section unhelpful for you?

DELETE

/api/v1/wallets

Select
1 2 3 4 5 6 7 curl --location --request DELETE 'https://api.ethedrops.dropstab.com/api/v1/wallets' \ --data '{ "wallets": [ "", "60f3b3b3b3b3b3b3b3b3b3b3" ] }'

Response

{
  "requestId": "",
  "result": false,
  "success": false,
  "timestamp": null
}
Was this section helpful?

What made this section unhelpful for you?

Etherdrops API

EtherDrops API

Was this section helpful?

What made this section unhelpful for you?

Base URL

Host:

https://api.ethedrops.dropstab.com/

Language Box

Was this section helpful?

What made this section unhelpful for you?

Webhook