Ask for an invitation
Menu

Endpoint

List the eleven wallets

GET/v1/wallets

Always eleven items, in the fixed order ethereum, bsc, polygon, arbitrum, optimism, base, solana, tron, bitcoin, litecoin, dogecoin. Not paginated.

Scope a restricted key needs
wallets:read
Publishable key
Not allowed: secret or restricted key only
Idempotency-Key
Not used. A GET is already safe to repeat.

Parameters

Parameters of List the eleven wallets
ParameterType and placeMeaning
Orrerie-VersionstringheaderAPI version date. Default: the version the key was created with. Example 2026-10-11.

Example request

curl

curl https://api.orrerie.com/v1/wallets \
  -H "Authorization: Bearer $ORRERIE_SECRET_KEY"

JavaScript

const response = await fetch("https://api.orrerie.com/v1/wallets", {
  headers: {
    Authorization: `Bearer ${process.env.ORRERIE_SECRET_KEY}`,
  },
});
const result = await response.json();
if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
console.log(result);

Python

import os
import requests

response = requests.get(
    "https://api.orrerie.com/v1/wallets",
    headers={"Authorization": f"Bearer {os.environ['ORRERIE_SECRET_KEY']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")
print(result)

PHP

<?php
$request = curl_init('https://api.orrerie.com/v1/wallets');
curl_setopt_array($request, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('ORRERIE_SECRET_KEY'),
    ],
]);
$body = curl_exec($request);
if ($body === false) {
    throw new RuntimeException(curl_error($request));
}
$result = json_decode($body, true);
if (curl_getinfo($request, CURLINFO_HTTP_CODE) >= 400) {
    throw new RuntimeException($result['error']['code'] . ': ' . $result['error']['message']);
}
print_r($result);

Responses

200 OK

A list whose data holds wallet objects. Headers: Orrerie-Request-Id.

Example response, 200

{
  "object": "list",
  "url": "/v1/wallets",
  "has_more": false,
  "data": [
    {
      "id": "wal_9hantgm1cb32zmrt4tm5pq1v",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "ethereum",
      "status": "address_ready",
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "shape": "safe_1_4_1",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": false,
      "deployment_note": "Deployed with the first approved send; the fee account pays.",
      "native_asset": "ethereum:eth",
      "explorer_url": "https://etherscan.io/address/0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"
    },
    {
      "id": "wal_edzh8qhxx54qb3vfjv6d7jmv",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "bsc",
      "status": "address_ready",
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "shape": "safe_1_4_1",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": false,
      "deployment_note": "Deployed with the first approved send; the fee account pays.",
      "native_asset": "bsc:bnb",
      "explorer_url": "https://bscscan.com/address/0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"
    },
    {
      "id": "wal_706sr21pf21n2anc5gfxd2p0",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "polygon",
      "status": "address_ready",
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "shape": "safe_1_4_1",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": false,
      "deployment_note": "Deployed with the first approved send; the fee account pays.",
      "native_asset": "polygon:pol",
      "explorer_url": "https://polygonscan.com/address/0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"
    },
    {
      "id": "wal_m14h9qczp8dc8rf7hv1sy99f",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "arbitrum",
      "status": "address_ready",
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "shape": "safe_1_4_1",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": false,
      "deployment_note": "Deployed with the first approved send; the fee account pays.",
      "native_asset": "arbitrum:eth",
      "explorer_url": "https://arbiscan.io/address/0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"
    },
    {
      "id": "wal_f3t41svkczx9mcbfrnz5h4fg",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "optimism",
      "status": "address_ready",
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "shape": "safe_1_4_1",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": false,
      "deployment_note": "Deployed with the first approved send; the fee account pays.",
      "native_asset": "optimism:eth",
      "explorer_url": "https://optimistic.etherscan.io/address/0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"
    },
    {
      "id": "wal_bsfw07hymawmda7gg8jsyy3g",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "base",
      "status": "address_ready",
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "shape": "safe_1_4_1",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": false,
      "deployment_note": "Deployed with the first approved send; the fee account pays.",
      "native_asset": "base:eth",
      "explorer_url": "https://basescan.org/address/0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"
    },
    {
      "id": "wal_ftkkm8p8dpnxncymw1xe7gdb",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "solana",
      "status": "address_ready",
      "address": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV",
      "shape": "squads_vault",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": false,
      "deployment_note": "Deployed with the first approved send; the fee account pays.",
      "native_asset": "solana:sol",
      "explorer_url": "https://solscan.io/account/7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV"
    },
    {
      "id": "wal_43xc1k7ba4rh9hvskg0c9z5w",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "tron",
      "status": "address_ready",
      "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
      "shape": "tron_permissions",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": false,
      "deployment_note": "The 2-of-3 permissions are set with the first approved send; the TRON fee key pays in TRX.",
      "native_asset": "tron:trx",
      "explorer_url": "https://tronscan.org/#/address/TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
    },
    {
      "id": "wal_zjdztygt4g73zm0cdcjjf43k",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "bitcoin",
      "status": "active",
      "address": "bc1qrp33g0q5c5txsp9arysrx4k6zdkfs4nce4xj0gdcccefvpysxf3qccfmv3",
      "shape": "p2wsh",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": true,
      "deployment_note": null,
      "native_asset": "bitcoin:btc",
      "explorer_url": "https://mempool.space/address/bc1qrp33g0q5c5txsp9arysrx4k6zdkfs4nce4xj0gdcccefvpysxf3qccfmv3"
    },
    {
      "id": "wal_j6heebqvf0zdae6agfpdn8q3",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "litecoin",
      "status": "active",
      "address": "MQMcJhpWHYVeQArcZR3sBgyPZxxRtnH441",
      "shape": "p2sh_p2wsh",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": true,
      "deployment_note": null,
      "native_asset": "litecoin:ltc",
      "explorer_url": "https://litecoinspace.org/address/MQMcJhpWHYVeQArcZR3sBgyPZxxRtnH441"
    },
    {
      "id": "wal_jn66qta0zdm1xz76kehjs78n",
      "object": "wallet",
      "livemode": true,
      "created": "2026-09-02T09:16:20.000Z",
      "wallet_set": "wset_6tnmbah49h3xpfbgefw5f2jz",
      "network": "dogecoin",
      "status": "active",
      "address": "A8c3xNz2mqsDLFwv5KL5fpH12QEwDaoTXo",
      "shape": "p2sh",
      "threshold": 2,
      "owner_count": 3,
      "can_receive": true,
      "can_send": true,
      "deployed": true,
      "deployment_note": null,
      "native_asset": "dogecoin:doge",
      "explorer_url": "https://dogechain.info/address/A8c3xNz2mqsDLFwv5KL5fpH12QEwDaoTXo"
    }
  ]
}

Any other status: an error

A status of 400 or above answers with the error object. Branch on its code, never on its message.

Errors

This call has no error of its own. It answers with the errors every call can answer with: a bad key, a missing scope, an object that does not exist, the rate limit. Every error code has its own entry.