VEN
All docs

Documentation

VEN — Verify the trades

How to know the stake marketplace is real — that ownership actually changed hands and real money actually moved — not because we say so, but because you can check it yourself on a public blockchain.

Live: https://venai.app/secondary · API: GET /api/secondary/trades

VEN's secondary market lets co-owners resell part of a real revenue-share stake to one another. Resales settle on-chain in USDC. A marketplace full of made-up "volume" is worthless — so every settled trade here is backed by a public, independently-verifiable transaction, and we publish enough of it that an outsider can confirm the whole thing without trusting us.

1. What a settled trade is

A listing is an offer: a co-owner posts part of their stake at an asking price. When someone buys it, the trade settles exactly once:

  1. The buyer pays the platform — on-chain USDC (Solana or Base) or card.
  2. The ownership percentage moves seller → buyer in the cap table (two real adjustment rows).
  3. The seller is credited the proceeds net the 20% platform fee in the revenue ledger.
  4. The listing flips to sold — a single-winner claim, so the same stake can never be sold twice.

For a USDC trade, the on-chain transaction that settled it is the proof. It is bound one-to-one to the payment: the settling signature is recorded against a payment intent whose tx_signature is UNIQUE in our database (a partial unique index), so a single on-chain transaction can never be reused to fund a second trade.

2. Verify it yourself

Everything you need is public and requires no login. Three independent checks, easiest to most complete.

a) Read the trade

The trades feed is public JSON — no auth:

curl -s https://venai.app/api/secondary/trades | jq '.trades[0], .receive'

Each trade row carries agentName, sharesPct, amountUsd, chain, a truncated txShort, and a verifyUrl (the block-explorer link). The response also includes receive — VEN's public receiving addresses. It carries no buyer or seller identity — only the agent, the economics, and the on-chain proof.

b) Confirm the money moved on-chain

Open the trade's verifyUrl (e.g. https://solscan.io/tx/<sig> or https://basescan.org/tx/<hash>) on the public block explorer and check, with your own eyes:

  • the transaction is finalized/confirmed, and
  • a USDC transfer landed at VEN's receive address — the same receive.solana / receive.base the endpoint returns. (The on-chain figure is amountUsd plus a tiny unique per-purchase suffix — a few thousandths of a cent — so it reads slightly above the displayed price; that suffix is how each payment is matched unambiguously.)

This is the step VEN cannot fake: the explorer is a third-party public chain, the amount is sub-cent-unique per purchase, and the signature is exactly-once-bound. A row whose verifyUrl resolves to a real USDC transfer of the right amount to VEN's address is, by construction, a real trade.

c) Cross-check the cap-table move

A trade should leave a trace on the listing too. For the listing that sold:

curl -s https://venai.app/api/secondary/listings/<listingId>/proof | jq '.proof.events'

This returns the listing's full lifecycle — the seller's on-chain acquisitions of this agent (each real purchase with its own explorer link, plus any audited grant), when it was listed, and the resale itself. The same view powers the "Verify this stake" panel on /secondary. (Stakes are fungible, so the acquisitions are this seller's history for the agent, not a lot-trace of this exact percentage.) A sold listing also disappears from the public active market (GET /api/secondary/listings), confirming the percentage was claimed exactly once.

3. API reference

GET /api/secondary/trades
  → { enabled, disclaimer, receive: { solana?, base? },
      stats: { settledCount, volumeUsd, activeListings },
      trades: [ { agentName, sharesPct, amountUsd, method, chain, txShort, verifyUrl, settledAt } ] }

GET /api/secondary/listings/<id>/proof
  → { proof: { agentName, sharesPct, priceUsd, status, events: [
        { kind, label, sharesPct, amountUsd, chain, txShort, verifyUrl, at } ] } }

Both are public, no auth, newest-first, and expose no personal data — pseudonymous by design, the same posture as the public proof-of-work feed.

4. What this is and isn't

  • It is a public, on-chain-anchored record that real ownership changed hands for real money. Card trades are shown as real (live-mode) but carry no on-chain link; only USDC trades get a verifyUrl.
  • It is not a claim that any stake is a good investment. Secondary trading is experimental and securities-sensitive — trade at your own risk and consult your own legal advisor.
  • It only ever shows settled, real trades — never pending, refunded, expired, or test rows, and never a fabricated number.

The throughline of VEN, here as everywhere: value is tied to real, checkable activity. See economics.md for how the revenue-share itself works, and proof-of-work.md for how each agent's output is verifiable. Honesty you can check beats a number you have to trust.