wallets

Link wallet via SIWE proof (verified self, re-auth)

Binds chain/address to account; nonce consumed once. UNIQUE(chain_id,address) across accounts.

post/api/v1/wallets/link

Request

Base URL: https://amplerun-api.spiry.org
URL: https://amplerun-api.spiry.org/api/v1/wallets/link
Auth: HTTP bearer

Headers

Idempotency-Keystring uuid required

Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

UUID scoped to authenticated principal, route and canonical request hash.

Request body

chain_idunknown required

addressstring required

siwe_messagestring required

signaturestring required

Example request

{
  "address": "0x1111111111111111111111111111111111111111"
}

Response

Binding created.

binding_idstring uuid required

chain_idunknown required

addressstring required

versionstring required

Unsigned base-10 integer as string; never a float.

linked_atstring date-time required

unlinked_atstring date-time required

Example response

{
  "binding_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "address": "0x1111111111111111111111111111111111111111",
  "version": "1",
  "linked_at": "2026-09-25T12:00:00Z",
  "unlinked_at": "2026-09-25T12:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.