> For the complete documentation index, see [llms.txt](https://programmable.market/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://programmable.market/docs/developers/machine-readable.md). # API reference Module interfaces, launch API contracts and release discovery ## Module Mode Read [agent discovery](https://programmable.market/api/agent) for the current contribution workflow and CLI manifest. The [module API guide](https://programmable.market/developers/module-mode-api-v1.md) defines submission and review. The [indexer JSON contract](https://programmable.market/api/module-mode/indexer/v1) publishes the native source ABI and identity rules; the [indexing guide](/docs/developers/module-mode-indexing.md) explains the verification procedure. Read the current release from [Module Mode availability](https://programmable.market/api/module-mode). ## Custom Launch APIs Start with the [API quickstart](/docs/developers/custom-launch-quickstart.md). Use [live discovery](https://programmable.market/.well-known/programmable.json) to select a chain, profile and client release. | Integration | Contract | | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Robinhood, separate token and hook | V4 OpenAPI and pack configuration selected by discovery | | Robinhood, shared token and hook | [MultiRole V2 capabilities](https://api.programmable.market/v4/chains/4663/multi-role-custom-launches/capabilities) | | Ethereum | [V3 OpenAPI](https://programmable.market/openapi/custom-launch-v3.json) and [pack configuration](https://programmable.market/schemas/custom-launch/v3/pack-config.json) | | Detailed request and compatibility reference | [Custom Launch API](/docs/developers/custom-launch.md) and [raw agent guide](https://programmable.market/developers/custom-launch-api-v1.md) | Read `customLaunchApi.partnerCredentials` and `customLaunchApi.agentIntegration` in discovery. A partner root aggregates all partner-attributed launches; each subkey sees its stable lineage, and rotation preserves that history. Use `custom-launch:create` for preflight and creation and `custom-launch:read` for status. No API key can sign or broadcast a wallet transaction. The [agent remediation catalog](https://programmable.market/policies/custom-launch-agent-remediation-v1.json) explains structured errors and next steps. Preserve the exact request bytes and idempotency key when retrying. Include the returned request ID in support messages; never include the API key. ### Robinhood V4 Robinhood Chain Mainnet uses V4 at `eip155:4663`. CLI `3.3.9` remains the live Ethereum V3 integration. Read the V4 and chain 4663 entries in [live discovery](https://programmable.market/.well-known/programmable.json); require all three public gates and verify the advertised immutable CLI release, source commit, manifest and checksum. Stop while `pending-public-discovery-promotion`, `publicWrites: false`, `publicAuthorization: false` or `releaseReady: false` is reported. A deployed runtime or source candidate is not activation evidence. The [4.0 OpenAPI](https://programmable.market/openapi/custom-launch-v4.json), [pack config](https://programmable.market/schemas/custom-launch/v4/pack-config.json) and [source verification](https://programmable.market/schemas/custom-launch/v4/source-verification-status.json) preserve historical `4.0.0`. When discovery selects `4.1.0`, use its [OpenAPI](https://programmable.market/openapi/custom-launch-v4.1.json), [pack config](https://programmable.market/schemas/custom-launch/v4.1/pack-config.json) and [source verification](https://programmable.market/schemas/custom-launch/v4.1/source-verification-status.json). Selected 4.1 requires a request-bound funding plan, exact launch and gas budgets, an atomic initial buy of at least USD 1 at permit authorization, positive minimum token output and a fresh server quote. Gas is additional; count the buy once. Its exact fee kernel accrues 20 bps of the gross native ETH leg once per successful swap, separately from creator and LP fees, as fixed-recipient PoolManager native claims; admission is not collected-revenue proof. Read the [current generated agent guide](https://programmable.market/docs/developers.md) for the exact funding, quote and fee boundary. Use the returned `resource.launchId` as `LAUNCH_ID`, not the HTTP support request ID. A V4 client must poll with `programmable-launch status LAUNCH_ID --api-version 4 --chain-id 4663 --watch --until authorized`, stop for separate wallet review, signature and broadcast, then poll the same command with `--until finalized`. The CLI never signs or broadcasts. The V4 states are `received`, `validating`, `action_required`, `authorized`, `awaiting_wallet_signature`, `wallet_action_required`, `submitted`, `sequencer_soft_confirmed`, `ethereum_posted`, `finalized` and `failed`. `action_required` is remediation, not a wallet action. Source verification starts after finality and stays independent from indexing, trading and publication. ## Shared token and hook on Robinhood Use the separate [MultiRole V2 capabilities](https://api.programmable.market/v4/chains/4663/multi-role-custom-launches/capabilities), [guide](https://api.programmable.market/v4/chains/4663/multi-role-custom-launches/guide.md) and [client](https://api.programmable.market/v4/chains/4663/multi-role-custom-launches/client.mjs) for one contract that implements both token and hook. Its request, funding and lifecycle contract is separate from V4 4.1. The automatic economic verifier accepts the exact Native20 recipe and supported constructor configuration; different source code or economic mechanisms return `evidence_required`. Preflight/create uses `custom-launch:create`; status/list uses `custom-launch:read`, bound to chain `4663` and the controller. Native20 charges 20 bps (0.20%) of gross native ETH per successful buy or sell for Programmable, rounded up per trade. Creator and pool fees are additional. The [fees guide](/docs/economics.md) defines accruals, claims and the [Dune dashboard](https://dune.com/programmablehq/analytics) metrics. Track the [MultiRole finalized feed](https://api.programmable.market/v4/chains/4663/multi-role-custom-launches/finalized) separately from the existing V4 feed. ## Ethereum V3 and public reads On Ethereum Mainnet, `GET /v3/capabilities` describes the accepted profile and structural limits. Authenticated `POST /v3/custom-launches/preflight` evaluates the exact create bytes without consuming launch-creation quota, allocating a nonce or persisting a launch. It still consumes the ordinary route rate budget, including a partner credential's `prepareRequestsPerHour` budget. The Router V1 permit-reissue disposition route is wallet-key-only. The server verifies required behavior, fee and liquidity evidence before wallet handoff. A 10 bps platform fee claim applies only to an Ethereum fee-certified profile or adapter and its exact stamped PoolKey. This historical policy is separate from Robinhood Native20. Ethereum [V2](https://programmable.market/openapi/custom-launch-v2.json) and [V1](https://programmable.market/openapi/custom-launch-v1.json) preserve history and schemas. New creation returns nonretryable `409 CUSTOM_LAUNCH_V2_READ_ONLY` or `409 CUSTOM_LAUNCH_V1_READ_ONLY`; use the advertised V3 profile for new Ethereum submissions. The Developer API version 2 at `https://developers.programmable.family` is read only and requires no API key. The OpenAPI operations below describe that service, including discovery, deployment manifests and launch reads. ## Service status {% openapi src="/files/8A7o1kxAKbDPRvj4HKz9" path="/api/v2/status" method="get" %} [programmable-v2.yaml](https://3636039689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5DHFXw3C9Vu6yyEHLosa%2Fuploads%2Fgit-blob-c630a2ea44ed93279cb27986fba7a59ed9746e82%2Fprogrammable-v2.yaml?alt=media) {% endopenapi %} ## Deployment manifest {% openapi src="/files/8A7o1kxAKbDPRvj4HKz9" path="/api/v2/manifest" method="get" %} [programmable-v2.yaml](https://3636039689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5DHFXw3C9Vu6yyEHLosa%2Fuploads%2Fgit-blob-c630a2ea44ed93279cb27986fba7a59ed9746e82%2Fprogrammable-v2.yaml?alt=media) {% endopenapi %} ## Launches {% openapi src="/files/8A7o1kxAKbDPRvj4HKz9" path="/api/v2/launches" method="get" %} [programmable-v2.yaml](https://3636039689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5DHFXw3C9Vu6yyEHLosa%2Fuploads%2Fgit-blob-c630a2ea44ed93279cb27986fba7a59ed9746e82%2Fprogrammable-v2.yaml?alt=media) {% endopenapi %} ## Token list {% openapi src="/files/8A7o1kxAKbDPRvj4HKz9" path="/api/v2/token-list" method="get" %} [programmable-v2.yaml](https://3636039689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5DHFXw3C9Vu6yyEHLosa%2Fuploads%2Fgit-blob-c630a2ea44ed93279cb27986fba7a59ed9746e82%2Fprogrammable-v2.yaml?alt=media) {% endopenapi %} The canonical OpenAPI source is maintained in the [Developers repository](https://github.com/programmablehq/Developers/blob/main/openapi/programmable-v2.yaml). This copy is included so GitBook can render the interactive reference together with the official product documentation. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://programmable.market/docs/developers/machine-readable.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.