📚 Arkade network guide

A step-by-step guide to preparing an Arkade wallet at arkade.money, adding the BTC/DePix market to it, and swapping DePix. Use it to test Arkade payouts from POST /deposit end to end: the wallet you set up here gives you the ark1… address, and the DePix paid to that address lands in this same wallet.

Arkade is in beta

Arkade is live in the API, but still a beta. Please do not use it in production yet, and do not test it with substantial amounts. Always start with a small value. We will announce on the Changelog when it is ready for production use.

Before you start

A phone or a browser. The wallet runs at arkade.money; nothing to install.

A few satoshis. The first swap pays a small fee in BTC, so the wallet needs a little balance before the DePix market can be used.

Somewhere safe, offline, for the seed. You will write down the recovery words in step 1 and they are the only way back into the wallet.

1. Create and prepare the wallet

1.1 Open arkade.money

Open arkade.money and create a new wallet. Wait for it to finish loading before doing anything else.

The wallet's loading screen. Wait for it to finish.

1.2 Write down the seed and back it up

Store the recovery words somewhere safe and off the phone.

Never share your seed

No screenshots, no cloud, no e-mail, no messaging apps. Anyone holding the words holds the wallet.

1.3 Tap "Receive" and fund the wallet

Send a few satoshis to the wallet. This small balance pays the initial swap fees. The wallet accepts funds over three rails:

Lightning

Arkade

Bitcoin on-chain

1.4 Use the right address

On the receive screen, scan the QR code or copy the address that matches the network you are sending from. The Unified address is selected by default; if the sending wallet does not recognise it, copy Arkade address or Bitcoin address specifically.

Copy address screen with Unified, Arkade address and Bitcoin address

In "Receive", check and copy the address matching the network you are sending from.

This is your depixAddress

The Arkade address on this screen (it starts with ark1…) is the one to send as depixAddress on POST /deposit, or to configure as your default payout address. The DePix of every deposit paid to it shows up in this wallet.

2. Add the BTC/DePix solver

The DePix market is not in the wallet by default. Register the solver configuration below and the BTC/DePix pair appears.

Open Settings and tap Advanced.

In the advanced options, tap Solvers.

Tap + Add new. A field opens for the new solver configuration.

Paste the whole JSON below into that field, from the opening { to the closing }, without changing any value.

Confirm with the ✓ button.

Back on the list, check that the solver-ae6c048f card shows the BTC/DePix market.

Solver configuration (`solver-ae6c048f`)

{
  "markets": [
    {
      "base_asset": {
        "decimals": 8,
        "id": "btc",
        "name": "Bitcoin",
        "ticker": "BTC"
      },
      "fee_bps": 140,
      "max_base_amount": "10000000000000",
      "max_quote_amount": "10000000000000",
      "min_base_amount": "1001",
      "min_quote_amount": "330",
      "pair": "BTC/DePix",
      "price_decimals": 0,
      "price_feed": "https://api.binance.com/api/v3/ticker/price?symbol=BTCBRL",
      "price_feed_schema": {
        "price_path": "/price",
        "type": "json"
      },
      "quote_asset": {
        "decimals": 8,
        "id": "0abcbc23c60028511880807dfe42aa16de88bd56df210a0b9135262d5d3959510000",
        "name": "Decentralized PIX",
        "ticker": "DePix"
      }
    }
  ],
  "name": "solver-ae6c048f",
  "version": 0
}

The quote_asset.id is the DePix asset ID. Paste it exactly as shown: a single wrong character and the market points at a different asset.

Settings screen with the Advanced option

1. In "Settings", tap "Advanced".

2. Under "Advanced", open "Solvers".

Solvers screen with the field to paste the new solver JSON

3. Tap "+ Add new", paste the whole JSON and confirm with ✓.

Solver list showing solver-ae6c048f with the BTC/DePix market

4. Check that "solver-ae6c048f · BTC/DePix" is on the list.

Done

If the card solver-ae6c048f · BTC/DePix is visible, the market was added correctly.

3. Make the swap

With the market in place, the swap is made in the wallet itself: select BTC/DePix, enter the amount and confirm. A detailed walkthrough of this step, with screenshots, is being written and will be added here.

Start with a small amount. While Arkade is in beta, a swap that behaves oddly is worth reporting: quote the ark1… address you used and, if a deposit was involved, its id and the X-Request-ID (see Troubleshooting).

Deposit — POST /deposit with an ark1… address in depixAddress.

Glossary: Arkade — how the network is read from the address.

Troubleshooting — refusals on Arkade addresses and what to report.

📚 Arkade network guide

Before you start#

1. Create and prepare the wallet#

1.1 Open arkade.money#

1.2 Write down the seed and back it up#

1.3 Tap "Receive" and fund the wallet#

1.4 Use the right address#

2. Add the BTC/DePix solver#

Solver configuration (solver-ae6c048f)#

3. Make the swap#

Related pages#