Appearance
x402 (paid agent calls)
Some InvestHub calls are free. Some are not ready to run until the caller pays. HTTP 402 Payment Required is how the server says that. x402 is the protocol an agent uses to pay that call in USDC on Base, then retry the same request with proof of payment.
This page does not set prices for the MCP tools. Where a price is not already published, it is marked TODO. Do not invent one.
Not investment advice
Paying for an API call is not an investment, and it is not advice. Offerings are offered via a licensed partner (in review). InvestHub does not hold an ECSP licence. The interface fee goes to the Digihub.li Genossenschaft. Tokenized stocks (Coinbase B20 "c" tokens) are not for US persons.
How a paid call works
- The agent calls the endpoint with no payment header.
- The server answers 402 and lists what it will accept: scheme, network, amount, and the USDC asset.
- The agent's wallet signs a payment authorization. On the white-label tenant API this is an ERC-3009
transferWithAuthorizationon Base. The InvestHub server does not sign that authorization. - The agent retries the same call with the signed payload in the
X-PAYMENTheader. - The server verifies and settles the payment, then runs the call.
A 402 payment is separate from an investment, a vote, or a dividend claim. Those still come back as unsigned transactions. The person signs them in their wallet. See Agents & MCP.
Free tools
Reads, the catalog, and quotes are free:
about_investhubsearch_catalog,list_deals,get_deal,get_quoterisk_profile_questionnairelist_meetings,get_meeting,gv_list_proposals,gv_get_proposal(public metadata; a SIWE session does not by itself make the read a paid call)get_claimableadvisor_list_clients,advisor_client_view(still refused without the client's consent)propose_basket(uses the catalog already loaded; it does not refresh prices)
get_quote can return unsigned swap transactions. The quote itself is free. Routes that charge an interface fee charge 5%, and that fee goes to the Digihub.li Genossenschaft. That fee is part of the swap, not an x402 charge for the MCP call.
Premium tools
propose_basket_live is the premium path: the same basket rules as propose_basket, with a live catalog refresh.
TODO: publish the per-call price for propose_basket_live and for the other tools below before payment is turned on for them. No amount is stated here, because it is not decided.
The other tools prepare a change, a signature challenge, or an unsigned transaction. Treat them as premium until a price is published:
- Deals:
create_deal_draft,express_interest,commit_to_opportunity,prepare_invest - Profile:
assess_risk_profile,propose_profile_update,micro_knowledge_check,answer_knowledge_check,submit_profile_update,verify_profile_credential - Baskets:
prepare_basket_transactions - Advisors:
grant_advisor_consent,revoke_advisor_consent,advisor_set_limits,advisor_review_basket,advisor_confirm_profile_update - General meetings:
gv_siwe_nonce,gv_siwe_verify,gv_prepare_vote,gv_prepare_delegate,gv_prepare_wrap - Dividends:
prepare_claim
board_status, prepare_board, staking_status, and prepare_stake are not deployed. They are not paid calls. They return that they are not deployed and no transaction.
Already using x402
White-label tenant create and renew already use x402 on Base. The published fees, the 402 body, and the retry with X-PAYMENT are in the White-Label UI Tenants guide:
- Pricing — setup and monthly renewal
- Create a tenant —
POST /functions/v1/create-tenant-x402 - Renew a tenant —
POST /functions/v1/renew-tenant-x402
Use that guide for the amounts. This page does not repeat payment addresses.