RSS3 Documentation

Batch Get Accounts Activities

Retrieve activities associated with multiple accounts on all compatible networks. You can use various query parameters to filter and paginate the results, including limits on the number of activities and actions, timestamps, success status, direction, and more.

POST
/decentralized/accounts
/decentralized/accounts

Request Body

application/jsonRequired

Request body for batch retrieving activities for multiple accounts

accountsarray<string>

List of accounts to retrieve activities for

limitinteger

Specify the number of activities to retrieve

Default: 100Minimum: 1Maximum: 100

action_limitinteger

Specify the number of actions within the activity to retrieve

Default: 10Minimum: 1Maximum: 20

cursorstring

Specify the cursor used for pagination

since_timestampinteger

Retrieve activities starting from this timestamp

until_timestampinteger

Retrieve activities up to this timestamp

successboolean

Retrieve activities based on success status

directionstring

The direction of an activity.

Value in: "in" | "out" | "self"

networkarray<string>

Retrieve activities from the specified network(s)

tagarray<string>

Retrieve activities for the specified tag(s)

typearray<string>

Retrieve activities for the specified type(s)

platformarray<string>

Retrieve activities from the specified platform(s)

curl -X POST "https://gi.rss3.io/decentralized/accounts" \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": [
      "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
    ],
    "limit": 20,
    "action_limit": 10,
    "cursor": "string",
    "since_timestamp": 0,
    "until_timestamp": 0,
    "success": true,
    "direction": "out",
    "network": [
      "ethereum"
    ],
    "tag": [
      "transaction"
    ],
    "type": [
      "transfer"
    ],
    "platform": [
      "1inch"
    ]
  }'

A successful response with the activities from the specified account. The response includes details about each activity, such as its ID, timestamp, and associated actions.

{
  "data": [
    {
      "id": "0x840e42d573ebe1ff27a9e4914573b4e0518fcd685c7f9331d319abe854f780e3",
      "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "network": "ethereum",
      "from": "0xBAB4d1f27bAA7762a4d822B80C647F715922492f",
      "to": "0x7964B6A8aE5a71409e7E17a5b2669903A27997Ac",
      "index": 0,
      "platform": "1inch",
      "success": true,
      "tag": "transaction",
      "type": "transfer",
      "calldata": {
        "function_hash": "0x4022b75e"
      },
      "direction": "out",
      "fee": {
        "amount": "315699955320960",
        "decimal": 18
      },
      "timestamp": 1718689727,
      "total_actions": 1,
      "actions": [
        {
          "tag": "transaction",
          "type": "transfer",
          "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "to": "0xefC5f77c5AD5DB85bc287E80d8c3B88c3f27662C",
          "metadata": {
            "address": "0x7964B6A8aE5a71409e7E17a5b2669903A27997Ac",
            "value": "10000000000000000000000",
            "name": "PlayDoge",
            "symbol": "PLAY",
            "decimals": 18,
            "standard": "ERC-20"
          },
          "related_urls": [
            "https://etherscan.io/tx/0x840e42d573ebe1ff27a9e4914573b4e0518fcd685c7f9331d319abe854f780e3"
          ]
        }
      ]
    }
  ],
  "meta": {
    "cursor": "string"
  }
}