Skip to main content
See Settlement for what this does. This endpoint shows and changes the one network your deposits are gathered on.

Endpoint

To read it, your key needs wallets:read. To change it, wallets:write.

Reading your setting

string
Your settlement network, or null if you haven’t set one, which means settlement is off.
array
required
The networks you can choose from on your plan.
boolean
required
Whether settlement can be turned on for your account right now. If it’s false, you can’t change chain yet, and a PUT gets a 409 until it’s true.
string
required
Always "new_deposits". Changing chain never redirects a settlement that’s already on its way.

Changing your setting

string
required
One of the networks in chains, or null to turn settlement off.
You get back the same fields as the GET above, under settlement. Send {"chain": null} to turn it off.
On the Free plan, the only settlement network is Base.

Errors