Sinbad Partner API

curl -G https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/trades \
     -H "Authorization: Bearer <token>" \
     -d integrationId=integration_demo \
     -d partnerUserId=customer_demo

{
  "trades": [
    {
      "tradeId": "trade_demo",
      "status": "CREATED",
      "side": "BUY",
      "escrowId": "42",
      "chainId": 80002,
      "fiatCurrencyId": "usd",
      "paymentMethodId": "bank_transfer",
      "displayLabel": "Bank transfer",
      "merchant": {
        "fullName": "Example Merchant",
        "avatarUrl": null
      },
      "pricing": {
        "usdtAmount": "100",
        "customerFiatAmount": "100"
      },
      "createdAt": "2026-10-23T10:00:00.000Z",
      "updatedAt": "2026-10-23T10:00:00.000Z",
      "id": "trade_demo",
      "source": "partner",
      "transferNumber": "B2B-DEMO",
      "type": "SELL",
      "counterparty": {
        "displayName": "Alex",
        "partnerName": "Example Partner"
      },
      "fundedAt": "2026-10-23T10:00:00.000Z"
    }
  ],
  "nextCursor": null
}

List trades and history.

Credential: Customer session or partner secret

Before you call

A customer session, or an owning partner server credential without Origin.

Defaults to confirmed funded trades for the verified

partner, integration, customer, registered wallet and chain. Newest first,

up to 20 per page. includePending=true includes accepted pending trades and

definitive execution failures, ordered by stable createdAt and document ID.

Unsubmitted breakdowns/checkouts remain excluded. Summaries omit payment

instructions, proof contents and chat. Pass nextCursor as after to continue.

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.

AuthorizationBearer

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

Query parameters

integrationIdstringOptional

Required with a partner credential; must be authorized by that credential.

partnerUserIdstringOptional

Partner-only optional customer reference filter.

updatedSincedatetimeOptional

Partner-only lower bound on lifecycle updatedAt.

untildatetimeOptional

Partner-only upper watermark returned on page one; repeat on later pages.

limitintegerOptional1-100Defaults to 20

Partner list page size.

statusenumOptional

includePendingbooleanOptionalDefaults to false

afterstringOptional

Trade ID from nextCursor.

Response

Funded trade summaries and nextCursor.

tradeslist of objects

nextCursorstring or null

untildatetimeOptional

Returned for partner-server recovery; preserve across cursor pages.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

503

Service Unavailable Error