CashLink Blockchain Bottle API

Overview

This v2 API publicly reads the river, bottles, raw text, and Memo outputs. Create content with an anonymous bottle account or a member cldev_ developer token issued from Security settings.

Base URL: https://test-linking.cc/api/v2/blockchain-bottles

Authentication and scopes

Create an anonymous account with POST /accounts. Its clbtl_ access token and clbtr_ recovery code are shown only when created or rotated; CashLink stores only HMACs. Member tokens last at most 90 days and require blockchain-bottles:write for content or blockchain-bottles:blockchain for anchoring.

Send private requests with Authorization: Bearer TOKEN. Mutations require a 16–200 character Idempotency-Key. JSON uses data, links, and meta.contract_version=2; errors use RFC 9457 Problem Details. Private responses are no-store, and the API does not enable cross-origin CORS.

Anonymous payment and anchoring

An anonymous bottle always begins as a private draft. Read GET /blockchain-credit-quote, then create a payment order for the bottle. A sufficient zero-confirmation payment publishes the CashLink bottle and queues anchoring. A reorganization before anchoring hides it again; a reorganization after anchoring keeps it public and records the unit debt.

Main endpoints

• Public: GET /river, GET /bottles/{id}, GET /bottles/{id}/raw, and GET /memos/{txid}/{output}.
• Accounts: POST /accounts, POST /accounts/recover, GET /account, and POST /account/token-rotations.
• Owner: GET|POST /account/bottles, GET|PATCH /account/bottles/{id}, and POST /account/bottles/{id}/blockchain.
• Payments: POST /account/bottles/{id}/payment-orders, plus order status, events, and QR code.

Use the OpenAPI 3.1 document for authoritative fields, states, and response shapes.