# Polymarket US — Partner Integration

- [Who you are](https://partners.docs.polymarket.us/who-you-are.md): ISV or IB: which you are is set by your agreement, what it changes about the build, and where in this space the two implementations diverge.
- [ISV: start here](https://partners.docs.polymarket.us/start.md): The four things that break most ISV integrations, the responsibility split, and the gate sequence to production traffic.
- [IB: start here](https://partners.docs.polymarket.us/ib/start.md): What the IB space covers, the responsibility split that defines this path, and the gate sequence to production.
- [Environments and endpoints](https://partners.docs.polymarket.us/environments.md): The hostnames per environment, what differs between preprod and production, the three surfaces that are not yours, and how to get the proto bundle and generate stubs.
- [Authentication](https://partners.docs.polymarket.us/authentication.md): Generate and register your keypair, mint an access token with a signed client assertion, and understand the scopes and entitlements on that token.
- [Canonical token client](https://partners.docs.polymarket.us/token-client.md): The token client the rest of this space imports, in Python, TypeScript, bash and Go, plus the gRPC channel and per-call metadata helpers.
- [Firms, participants and accounts](https://partners.docs.polymarket.us/identity.md): You get two firms, not one. Where a participant ID comes from, where x-participant-id goes, and an account-scoped read end to end.
- [Limits and errors](https://partners.docs.polymarket.us/limits-and-errors.md): Every published limit with its scope, and the verbatim error strings, what each one means, and which ones are ours to fix.
- [KYC flow](https://partners.docs.polymarket.us/kyc.md): Submit an end user for verification, handle all four outcomes, and track the three identifiers that decide who can trade.
- [Document verification](https://partners.docs.polymarket.us/docv.md): Drive the hosted document-upload flow and the optional prefill step that sit either side of POST /v1/kyc/start.
- [Webhooks and sandbox](https://partners.docs.polymarket.us/webhooks.md): One registered URL per firm delivers terminal KYC events, and preprod fixtures let you drive each outcome on demand.
- [Legal agreements](https://partners.docs.polymarket.us/legal-agreements.md): The four documents your users must accept, the six requirements on how you present them, and why you must not host your own copies.
- [Funding and transfers](https://partners.docs.polymarket.us/funding.md): Pre-position a pool, move cash into a participant account with CashMovementService, and handle the residue you cannot move.
- [Balances, fees and reconciliation](https://partners.docs.polymarket.us/balances.md): Compute spendable and withdrawable cash, track and collect your own vendor fees, and close a daily cash reconciliation.
- [Instruments and money on the wire](https://partners.docs.polymarket.us/instruments.md): Walk the instrument hierarchy, then convert prices, quantities, cash and fees with the two scales you read off the instrument.
- [Place an order](https://partners.docs.polymarket.us/orders.md): CreateVendorOrder end to end: the one time-in-force it accepts, four worked order shapes, and the taker coefficient you always pay.
- [Outcomes and recovery](https://partners.docs.polymarket.us/outcomes.md): Tell a filled fill-or-kill from a killed one, resolve a PENDING order without doubling a position, and skip the cancel path.
- [Streams](https://partners.docs.polymarket.us/streams.md): Which of the five gRPC streams carries what, which ones resume, and how to subscribe to each.
- [Reconnect and recover gaps](https://partners.docs.polymarket.us/reconnect.md): The subscription session model, the revoked-session error and its workaround, the real timeouts, and per-stream gap recovery.
- [Settlement](https://partners.docs.polymarket.us/settlement.md): Who credits the user at resolution, how to detect that a market resolved, the five settlement fields, and cancelled markets.
- [Preprod and testing](https://partners.docs.polymarket.us/preprod.md): What preprod mirrors, what it does not, and which test flows you cannot drive to a known outcome today.
- [Certification](https://partners.docs.polymarket.us/certification.md): The UAT gate between preprod and production, as assertions you can work through and a reviewer can sign off.
- [Running it](https://partners.docs.polymarket.us/operations.md): Export a day of trades, close your books daily, track breaking changes, and report a problem so it can be diagnosed.
- [Support and escalation](https://partners.docs.polymarket.us/support.md): Where to take a problem, what to include by category, how severity is read, and the routes that are not yet defined.
- [You own KYC](https://partners.docs.polymarket.us/kyc-ownership.md): What IB ownership of end-user KYC means today, what we still require on every participant, and why to enable document verification now.
- [Funds handling](https://partners.docs.polymarket.us/funds.md): Why an IB may not hold customer funds, what account structure that leaves you, and the unresolved omnibus position.
- [Regulatory](https://partners.docs.polymarket.us/regulatory.md): The ten reports, the NFA/CFTC demo, the risk-monitoring overview, and the record rules that make NFA reports error.
- [Support and escalation for IBs](https://partners.docs.polymarket.us/ib/support.md): IB-specific escalation routes, what to include on a regulatory or reporting question, and how severity is read.