Sinbad Partner API

curl -X PATCH https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/preferences \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "preferredCurrencyId": "usd",
  "locale": "en"
}'

{
  "tradeLimits": {
    "dailyUsageUsd": 0,
    "lifetimeUsageUsd": 0,
    "volumeCapsEnforced": false,
    "maxActiveBuy": 1,
    "maxActiveSell": 1
  },
  "userId": "user_demo",
  "partnerUserId": "customer_demo",
  "fullName": "Alex Example",
  "emailVerified": true,
  "walletAddress": "0x19e7e376e7c213b7e7e7e46cc70a5dd086daff2a",
  "chainId": 80002,
  "preferredName": "Alex",
  "email": "alex@example.com",
  "country": "GB",
  "locale": "en",
  "preferredCurrencyId": "usd",
  "primaryCurrencyAddress": "0x4444444444444444444444444444444444444444",
  "enableUSDT": true,
  "dateOfBirth": "1995-04-12"
}

Update customer preferences.

Credential: Customer session

Before you call

A customer session for the same partner, integration, customer, wallet and chain.

A preferred currency must be globally enabled and not blocked by the partner.

Confirm with Sinbad that this endpoint is enabled in your environment.

Errors

Status	Code	What to do
400	`VALIDATION_ERROR`	Correct the fields reported in details before retrying.
401	`UNAUTHENTICATED`	Create a new customer session or use a valid server credential.
403	`FORBIDDEN`	Check credential ownership, integration and the supplied Origin.
409	`CONFLICT`	Read the current state again before you prepare or retry.
503	`UPSTREAM_ERROR`	Retry with backoff; preserve the same idempotency key for a repeated mutation.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

preferredCurrencyIdstringOptional

localestringOptionalformat: "^[A-Za-z0-9-]+$"2-35 characters

Response

Updated profile

tradeLimitsobject

userIdstring

partnerUserIdstring

fullNamestring

emailVerifiedboolean

walletAddressstring

chainIdinteger

preferredNamestringOptional

emailstringOptionalformat: "email"

phonestringOptional

phoneVerifiedbooleanOptional

countrystringOptional

localestringOptional

preferredCurrencyIdstringOptional

primaryCurrencyAddressstringOptional

Configured USDT contract address, normalized lowercase. Set on session mint.

enableUSDTbooleanOptional

True for the current USDT-only customer configuration.

dateOfBirthdateOptional

Optional date of birth asserted during session minting.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

503

Service Unavailable Error