Sinbad Partner API

{
  "merchant": {
    "fullName": "Demo merchant",
    "avatarUrl": "https://example.com/avatar.png",
    "username": "demo_merchant",
    "ratingPercent": 98,
    "tradeCount": 1240,
    "isSuperMerchant": true,
    "experienceYears": 3
  },
  "breakdownId": "breakdown_demo",
  "createdAt": "2026-10-23T10:00:00.000Z",
  "expiresAt": "2026-10-23T10:05:00.000Z",
  "serverTime": "2026-10-23T10:00:00.000Z",
  "side": "BUY",
  "status": "AWAITING_FUNDING",
  "tradeId": null,
  "tradeDetails": {
    "Amount": {
      "value": 100,
      "type": "crypto"
    },
    "MerchantRate": {
      "value": 1,
      "type": "fiat"
    },
    "Subtotal": {
      "value": 100,
      "type": "fiat"
    },
    "ServiceFee": {
      "value": 0,
      "type": "fiat"
    },
    "YouPay": {
      "value": 100,
      "type": "fiat"
    }
  },
  "merchantRateDetails": {
    "MarketRate": {
      "value": 1,
      "type": "fiat"
    },
    "MerchantMargin": {
      "value": 0,
      "type": "percentage"
    },
    "MerchantRate": {
      "value": 1,
      "type": "fiat"
    }
  },
  "fiatCurrency": {
    "id": "usd",
    "code": "USD",
    "name": "US Dollar",
    "symbol": "$",
    "decimals": 2
  },
  "paymentMethod": {
    "paymentMethodId": "bank_transfer",
    "displayLabel": "Bank transfer",
    "isActive": true,
    "_logoURL": "",
    "id": "account_demo"
  },
  "submission": null,
  "escrowTransaction": {
    "chainId": 80002,
    "data": "0x96f5f7d4cd8bdc71c97deb8b806e60f4592418d63f87a7d064f8a848e1cac1012c43280ffdf1c2b36f2ea80f9cc1a9bb5aed70dbd50cba3db1f3d9e742e5687cb228970b0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000222222222222222222222222222222222222222200000000000000000000000019e7e376e7c213b7e7e7e46cc70a5dd086daff2a00000000000000000000000044444444444444444444444444444444444444440000000000000000000000000000000000000000000000000000000005f5e100000000000000000000000000000000000000000000000000000000006adb314c00000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000041111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111100000000000000000000000000000000000000000000000000000000000000",
    "expiresAt": "2026-10-23T10:05:00.000Z",
    "from": "0x19e7e376e7c213b7e7e7e46cc70a5dd086daff2a",
    "preparationId": "preparation_escrow",
    "purpose": "createEscrow",
    "to": "0x3333333333333333333333333333333333333333",
    "value": "0"
  },
  "approvalRequired": false,
  "approval": {
    "allowance": "0",
    "required": false,
    "requiredAmount": "0",
    "spender": "0x3333333333333333333333333333333333333333",
    "tokenAddress": "0x4444444444444444444444444444444444444444"
  }
}

Get a trade breakdown.

Credential: Customer session

Before you call

A customer session for the same partner, integration, customer, wallet and chain.
An active saved account matching the catalog payment method.
A registered customer wallet and supported chain.

Reads a breakdown that belongs to the authenticated customer’s partner, integration, wallet and chain. The response contains the stored pricing and status. It never reprices a breakdown or extends its deadline.

Funding status is independent of transaction jobs. AWAITING_FUNDING can remain after the signing deadline while Sinbad catches up on confirmed blocks, and EXPIRED is reported only once Sinbad has checked the chain past that deadline. Poll this endpoint even if you never submitted a transaction hash.

A breakdown that a newer request replaced returns 409 CONFLICT, unless its escrow transaction funded anyway. In that case the call returns CONFIRMED with the original pricing and no escrowTransaction or approval transactions to sign.

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.
404	`NOT_FOUND`	Check the resource ID. A resource that belongs to someone else also returns 404.
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.

Path parameters

breakdownIdstringRequired

Response

Financial breakdown, prepared escrow call, approval state and current submission status.

merchantobject

Offer values are current observations; breakdown POST, GET and retries return the same creation snapshot.

breakdownIdstring

createdAtdatetime

expiresAtdatetime

Fresh breakdown creation plus 300 seconds.

serverTimedatetime

sideenum

Allowed values:

statusenum

Confirmed escrow outcome, independent of optional transaction tracking.

Allowed values:

tradeIdstring or null

tradeDetailsobject

Send exactly one of: YouPay, or YouReceive.

merchantRateDetailsobject

fiatCurrencyobject

paymentMethodobject

submissionobject or null

escrowTransactionobject or map from strings to anyOptional

Use this escrow call after approvals confirm. Nonce/gas/fees are populated by the signer, not pinned before approval.

approvalRequiredbooleanOptional

Allowance when the breakdown was created. Sinbad rechecks it when you submit.

approvalobject or map from strings to anyOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

503

Service Unavailable Error