# Sinbad Partner API

> P2P onramp and offramp infrastructure for fintechs. Guides, API reference and webhooks for Sinbad partners.

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getsinbad.com/_mcp/server

## Docs

- [Build a P2P flow with Sinbad](https://docs.getsinbad.com/introduction.md): Your server creates a customer session. Your app uses it to find an offer, sign an escrow transaction and complete the trade.
- [Quick start](https://docs.getsinbad.com/getting-started.md): Create a customer session, save a payment account and fund your first trade on staging.
- [Integration overview](https://docs.getsinbad.com/custom-api.md): Which parts of your product call Sinbad, with which credential, and in what order.
- [Concepts](https://docs.getsinbad.com/concepts.md): The five names you need: partner, integration, credential, user and session.
- [Authentication](https://docs.getsinbad.com/authentication.md): Use the partner secret on your server and the session token in your app. Sinbad checks ownership, origin, expiry and revocation on every request.
- [Buy walkthrough](https://docs.getsinbad.com/buy-walkthrough.md): Walk a customer through buying USDT from a merchant, from the first offer to the release.
- [Sell walkthrough](https://docs.getsinbad.com/sell-walkthrough.md): Walk a customer through selling USDT to a merchant, from the first offer to the release.
- [Wallets and gas](https://docs.getsinbad.com/wallets-and-gas.md): Sign customer transactions, pay network fees in POL and recover safely when you do not know whether a submission reached the chain.
- [Disputes](https://docs.getsinbad.com/disputes.md): Open a dispute when a trade is stuck, follow it on the trade, and close it by mutual resolution.
- [Limits and limitations](https://docs.getsinbad.com/limits-and-limitations.md): Rate limits, size limits, timings and idempotency rules, plus the known limitations to plan for before you go live.
- [Go-live checklist](https://docs.getsinbad.com/go-live.md): What to complete on staging, and what to confirm with Sinbad, before you send real customers to production.
- [Create a session](https://docs.getsinbad.com/sessions.md): Your server creates a reusable session for each authenticated customer.
- [Current session](https://docs.getsinbad.com/customer-session.md): Read or revoke the session the customer is using.
- [Profile and preferences](https://docs.getsinbad.com/customer.md): Read the authenticated customer and update their supported preferences.
- [Saved payment accounts](https://docs.getsinbad.com/payment-accounts.md): Manage a customer's fiat payment accounts using the fields the catalog defines.
- [Reference data](https://docs.getsinbad.com/reference-data.md): Read the supported currencies, countries and payment methods.
- [Offers and breakdowns](https://docs.getsinbad.com/offers-quotes.md): Find an offer, create a breakdown and show the customer the exact terms before they sign.
- [Sign and track transactions](https://docs.getsinbad.com/transactions.md): Execute prepared transactions with the customer's wallet and follow them until the escrow is confirmed.
- [Trade lifecycle](https://docs.getsinbad.com/trades.md): Follow a trade from funded escrow to a final outcome, and see who can act in each status.
- [Trades and history](https://docs.getsinbad.com/trade-history.md): List a customer's trades from your app, or reconcile your records from your server.
- [Chat and images](https://docs.getsinbad.com/trade-chat.md): Send text or images to the merchant and read the conversation history.
- [Payment proof](https://docs.getsinbad.com/payment-proof.md): Upload, read, replace or remove the active payment receipt for a trade.
- [Trade actions](https://docs.getsinbad.com/trade-actions.md): The five settlement actions a customer can take on a funded trade, and how every action is prepared, signed and submitted.
- [Customer management](https://docs.getsinbad.com/revoke.md): Find a customer, revoke their sessions, or delete them.
- [Partner configuration](https://docs.getsinbad.com/partner-config.md): Manage your partner's defaults and country restrictions.
- [Partner fees](https://docs.getsinbad.com/partner-fees.md): Read the active fee rules, save a draft schedule and publish it through your manager wallet.
- [Webhooks](https://docs.getsinbad.com/webhooks.md): Register an endpoint, verify its signatures and operate it for trade and message events.
- [Mark a trade paid](https://docs.getsinbad.com/trade-actions/mark-paid.md): Prepare the markPaid transaction for the customer's wallet to sign.
- [Release escrow](https://docs.getsinbad.com/trade-actions/release.md): Prepare the release transaction for the customer's wallet to sign.
- [Cancel before payment](https://docs.getsinbad.com/trade-actions/cancel-pre-paid.md): Prepare the cancelPrePaid transaction for the customer's wallet to sign.
- [Open a dispute](https://docs.getsinbad.com/trade-actions/open-dispute.md): Prepare the openDispute transaction for the customer's wallet to sign.
- [Resolve a dispute by concession](https://docs.getsinbad.com/trade-actions/mutual-resolve-dispute.md): Prepare the mutualResolveDispute transaction for the customer's wallet to sign.
- [trade.created](https://docs.getsinbad.com/webhook-events/trade-created.md): Signed notification from Sinbad to your registered HTTPS receiver.
- [trade.updated](https://docs.getsinbad.com/webhook-events/trade-updated.md): Signed notification from Sinbad to your registered HTTPS receiver.
- [trade.message.created](https://docs.getsinbad.com/webhook-events/trade-message-created.md): Signed notification from Sinbad to your registered HTTPS receiver.
- [webhook.test](https://docs.getsinbad.com/webhook-events/webhook-test.md): Signed notification from Sinbad to your registered HTTPS receiver.
- [Errors and recovery](https://docs.getsinbad.com/errors.md): Check the HTTP status and error.code. Use details for recovery decisions and keep requestId when asking Sinbad to trace a failed call.

## API Docs

- API Reference > Public [Check API health](https://docs.getsinbad.com/api-reference/public/health.md)
- API Reference > Public [Get session verification keys](https://docs.getsinbad.com/api-reference/public/signing-keys.md)
- API Reference > Sessions [Create a customer session](https://docs.getsinbad.com/api-reference/sessions/create-customer-session.md)
- API Reference > Sessions [Get the current session](https://docs.getsinbad.com/api-reference/sessions/get-customer-session.md)
- API Reference > Sessions [Log out the current session](https://docs.getsinbad.com/api-reference/sessions/revoke-current-customer-session.md)
- API Reference > Customer Management [Revoke one customer session](https://docs.getsinbad.com/api-reference/customer-management/revoke-customer-session.md)
- API Reference > Customer Management [Revoke all sessions for a customer](https://docs.getsinbad.com/api-reference/customer-management/revoke-partner-user-sessions.md)
- API Reference > Customer Management [List partner customers](https://docs.getsinbad.com/api-reference/customer-management/list-partner-users.md)
- API Reference > Customer Management [Delete a partner customer](https://docs.getsinbad.com/api-reference/customer-management/delete-partner-user.md)
- API Reference > Reference Data [List supported currencies](https://docs.getsinbad.com/api-reference/reference-data/list-currencies.md)
- API Reference > Reference Data [List countries and effective policy](https://docs.getsinbad.com/api-reference/reference-data/list-countries.md)
- API Reference > Reference Data [List catalog payment methods](https://docs.getsinbad.com/api-reference/reference-data/list-payment-method-catalog.md)
- API Reference > Reference Data [List currencies for a payment method](https://docs.getsinbad.com/api-reference/reference-data/list-payment-method-currencies.md)
- API Reference > Customer Profile [Get the customer profile](https://docs.getsinbad.com/api-reference/customer-profile/get-customer-profile.md)
- API Reference > Customer Profile [Update customer preferences](https://docs.getsinbad.com/api-reference/customer-profile/update-widget-preferences.md)
- API Reference > Customer Profile [Get effective geo policy](https://docs.getsinbad.com/api-reference/customer-profile/get-effective-geo-policy.md)
- API Reference > Payment Accounts [List saved payment accounts](https://docs.getsinbad.com/api-reference/payment-accounts/list-saved-payment-methods.md)
- API Reference > Payment Accounts [Add a payment account](https://docs.getsinbad.com/api-reference/payment-accounts/create-saved-payment-method.md)
- API Reference > Payment Accounts [Delete a payment account](https://docs.getsinbad.com/api-reference/payment-accounts/delete-saved-payment-method.md)
- API Reference > Payment Accounts [Update a payment account](https://docs.getsinbad.com/api-reference/payment-accounts/update-saved-payment-method.md)
- API Reference > Partner Configuration [Get partner configuration](https://docs.getsinbad.com/api-reference/partner-configuration/get-partner-config.md)
- API Reference > Partner Configuration [Update partner configuration](https://docs.getsinbad.com/api-reference/partner-configuration/update-partner-config.md)
- API Reference > Partner Configuration [List partner country blocks](https://docs.getsinbad.com/api-reference/partner-configuration/list-partner-country-blocks.md)
- API Reference > Partner Configuration [Block a country](https://docs.getsinbad.com/api-reference/partner-configuration/block-partner-country.md)
- API Reference > Partner Configuration [Remove a country block](https://docs.getsinbad.com/api-reference/partner-configuration/unblock-partner-country.md)
- API Reference > Offers and Breakdowns [Find the best offer](https://docs.getsinbad.com/api-reference/offers-and-breakdowns/find-best-offer.md)
- API Reference > Offers and Breakdowns [Create a trade breakdown](https://docs.getsinbad.com/api-reference/offers-and-breakdowns/create-trade-breakdown.md)
- API Reference > Offers and Breakdowns [Get a trade breakdown](https://docs.getsinbad.com/api-reference/offers-and-breakdowns/get-trade-breakdown.md)
- API Reference > Transactions [Prepare token approval](https://docs.getsinbad.com/api-reference/transactions/prepare-token-approval.md)
- API Reference > Transactions [Submit or track a signed transaction](https://docs.getsinbad.com/api-reference/transactions/submit-prepared-transaction.md)
- API Reference > Transactions [Get transaction confirmation status](https://docs.getsinbad.com/api-reference/transactions/get-prepared-transaction-status.md)
- API Reference > Trades [List trades and history](https://docs.getsinbad.com/api-reference/trades/list-partner-trades.md)
- API Reference > Trades [Get trade details](https://docs.getsinbad.com/api-reference/trades/get-partner-trade.md)
- API Reference > Trade Messages [List trade messages](https://docs.getsinbad.com/api-reference/trade-messages/list-partner-trade-messages.md)
- API Reference > Trade Messages [Send a trade message](https://docs.getsinbad.com/api-reference/trade-messages/send-partner-trade-message.md)
- API Reference > Trade Messages [Read a private message attachment](https://docs.getsinbad.com/api-reference/trade-messages/get-partner-trade-message-image.md)
- API Reference > Payment Proof [Read the current payment proof](https://docs.getsinbad.com/api-reference/payment-proof/get-partner-trade-proof.md)
- API Reference > Payment Proof [Upload payment proof](https://docs.getsinbad.com/api-reference/payment-proof/upload-partner-trade-proof.md)
- API Reference > Payment Proof [Remove payment proof](https://docs.getsinbad.com/api-reference/payment-proof/delete-partner-trade-proof.md)
- API Reference > Payment Proof [Replace payment proof](https://docs.getsinbad.com/api-reference/payment-proof/replace-partner-trade-proof.md)
- API Reference > Trade Actions [Prepare a trade action](https://docs.getsinbad.com/api-reference/trade-actions/prepare-partner-customer-action.md)
- API Reference > Partner Fees [Get active fees and the draft](https://docs.getsinbad.com/api-reference/partner-fees/get-partner-fees.md)
- API Reference > Partner Fees [Save a fee schedule draft](https://docs.getsinbad.com/api-reference/partner-fees/save-partner-fee-draft.md)
- API Reference > Partner Fees [Prepare fee schedule publication](https://docs.getsinbad.com/api-reference/partner-fees/prepare-partner-fee-publication.md)
- API Reference > Webhooks [List webhook endpoints](https://docs.getsinbad.com/api-reference/webhooks/list-webhooks.md)
- API Reference > Webhooks [Register a webhook endpoint](https://docs.getsinbad.com/api-reference/webhooks/create-webhook.md)
- API Reference > Webhooks [Get a webhook endpoint](https://docs.getsinbad.com/api-reference/webhooks/get-webhook.md)
- API Reference > Webhooks [Delete a webhook endpoint](https://docs.getsinbad.com/api-reference/webhooks/delete-webhook.md)
- API Reference > Webhooks [Update or pause a webhook](https://docs.getsinbad.com/api-reference/webhooks/update-webhook.md)
- API Reference > Webhooks [Verify a webhook receiver](https://docs.getsinbad.com/api-reference/webhooks/test-webhook.md)
- API Reference > Webhooks [Rotate a webhook signing secret](https://docs.getsinbad.com/api-reference/webhooks/rotate-webhook.md)
- API Reference > Webhooks [List webhook deliveries](https://docs.getsinbad.com/api-reference/webhooks/list-webhook-deliveries.md)
- API Reference > Webhooks [Inspect a webhook delivery](https://docs.getsinbad.com/api-reference/webhooks/get-webhook-delivery.md)
- API Reference > Webhooks [Replay a failed webhook delivery](https://docs.getsinbad.com/api-reference/webhooks/replay-webhook-delivery.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.getsinbad.com/openapi.json)
- [OpenAPI YAML](https://docs.getsinbad.com/openapi.yaml)