alpaca-broker-account-onboarding

Create and manage brokerage accounts with KYC via the Alpaca Broker API.

4|Updated Aug 28, 2026
One-click install
npx skills add https://github.com/alan-d-smith/synthetix-alpha --skill alpaca-broker-account-onboarding-alan-d-smith
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: alpaca-broker-account-onboarding
Source: https://github.com/alan-d-smith/synthetix-alpha/tree/main/.agents/skills/alpaca-broker-account-onboarding
Command: npx skills add https://github.com/alan-d-smith/synthetix-alpha --skill alpaca-broker-account-onboarding-alan-d-smith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Opening end-user brokerage accounts programmatically requires navigating KYC/CIP verification, identity disclosures, legal agreements, document uploads, and a multi-stage account status lifecycle, and mistakes in any of these block funding and trading downstream. ## Core Features & Use Cases - Account Creation & Management: Covers the full /v1/accounts endpoint surface including create, list, get, update, and close, with the required contact, identity, disclosures, and agreements objects. - KYC & Document Handling: Explains document upload types, the W-8BEN structured JSON shortcut where Alpaca renders the official form, and submitting CIP results from providers like Onfido or Trulioo. - Status Lifecycle Gating: Maps the AccountStatus enum from SUBMITTED through ACTIVE and teaches gating all funding, journaling, and trading on the ACTIVE state. - Use Case: A developer building a fintech app uses this to onboard a non-US user: normalize the country code to ISO 3166-1 alpha-3, submit the account with a structured W-8BEN, then subscribe to status events before enabling deposits. ## Quick Start Use the alpaca-broker-account-onboarding skill to create a new brokerage account for a user with contact, identity, disclosures, and agreements, then tell me how to track it until it becomes ACTIVE.

Frequently Asked Questions about alpaca-broker-account-onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a brokerage account with the Alpaca Broker API?▼

Send a POST request to /v1/accounts with four required objects: contact, identity, disclosures, and agreements. A 200 response returns the account object, but the account is not tradable until its status reaches ACTIVE.

How do I submit a W-8BEN form through the Alpaca API?▼

Upload a document with document_type w8ben using content_data containing a structured W8benDocument JSON object instead of a PDF. Alpaca renders the official form from the JSON, which is the cleanest way to satisfy the tax-form requirement for non-US persons.

What account statuses does the Alpaca Broker API use?▼

The AccountStatus enum includes ONBOARDING, SUBMITTED, ACTION_REQUIRED, APPROVAL_PENDING, APPROVED, ACTIVE, REJECTED, and ACCOUNT_CLOSED. The happy path is SUBMITTED to APPROVAL_PENDING to APPROVED to ACTIVE, and only ACTIVE permits funding and trading.

Why does Alpaca account creation return a 422 error?▼

A 422 means an invalid field value, most commonly a malformed country code. Country fields must be ISO 3166-1 alpha-3 like USA or PHL, so strip UI decorations and validate against GET /v1/country-info before submitting.

Can I use my own KYC provider with Alpaca Broker API?▼

Yes, you can run KYC through providers like Onfido, Trulioo, or Veriff and submit results via POST /v1/accounts/{id}/cip with a CIPInfo body. Sub-check results are reported as clear or consider, and self-run KYC removes the 10 MB document size cap.

What must I do before closing an Alpaca brokerage account?▼

You must liquidate all positions and withdraw all cash before calling POST /v1/accounts/{id}/actions/close. The account record is not deleted; it transitions to ACCOUNT_CLOSED status.