Skip to main content
POST
/
users
/
me
/
external-id
Link partner external user ID (HMAC-verified)
curl --request POST \
  --url https://api.agg.market/users/me/external-id \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-app-id: <api-key>' \
  --data '
{
  "externalId": "<string>",
  "timestamp": 1,
  "hmac": "<string>"
}
'
{
  "id": "<string>",
  "username": "<string>",
  "avatarUrl": "<string>",
  "externalId": "<string>",
  "accounts": [
    {
      "type": "oauth",
      "provider": "wallet",
      "providerAccountId": "<string>"
    }
  ],
  "wallets": [
    {
      "chain": "evm",
      "address": "<string>"
    }
  ]
}

Authorizations

x-app-id
string
header
required

Your application ID. Required for all app-tier and user-tier routes.

Authorization
string
header
required

JWT access token returned by POST /auth/verify. Required for user-tier routes.

Body

application/json

Body

externalId
string
required
Required string length: 1 - 255
timestamp
integer
required
Required range: x > 0
hmac
string
required
Pattern: ^[a-fA-F0-9]{64}$

Response

200

id
string
required
username
string | null
required
avatarUrl
string | null
required
externalId
string | null
required
accounts
object[]
required
wallets
object[]
required