🌾 Oppium

The Opportunity Network Powered by Solutia.ai

REST + MCP The Oppium API — the opportunity network. People, assets and demand connect through typed signals so opportunities reach the actors who can act on them. Base URL https://www.oppium.com/api/v1. Auth is a Sanctum bearer token from POST /auth/login (or the passwordless demo sign-in below). Sign in to explore live with seeded demo data.

1. Demo accounts (passwordless — click a row to load it; sign-in uses `/auth/demo-login`)

Persona	Email	Market
Revendeuse — Abidjan	[email protected]	CI
Mareyeuse — Abidjan	[email protected]	CI
Chauffeur — Abidjan	[email protected]	CI
Job seeker — Lagos	[email protected]	NG
Driver — Lagos	[email protected]	NG
[Démo] Coach business — Dakar	[email protected]	SN
[Démo] Reseller — fresh (test apply+quiz)	[email protected]	SN
Revendeuse — Dakar	[email protected]	SN
[Démo] Supplier — Acme Distribution	[email protected]	SN
[Démo] Expert agronome — Thiès/Mbour	[email protected]	SN
[Démo] Reseller — authorized	[email protected]	SN
[Démo] Grossiste — TH	[email protected]	SN
Grossiste — Dakar	[email protected]	SN
[Démo] Reseller — applied + passed	[email protected]	SN
[Démo] Producteur — Mbour	[email protected]	SN
Productrice — Thiès	[email protected]	SN
Étudiante — Dakar	[email protected]	SN

2. Try the API right here

Demo account

Pick a demo account and click "Sign in (demo)". The token stays in this page only — never sent to a third party.

3. Public endpoints (no auth)

POST /api/v1/auth/register — sign up
POST /api/v1/auth/login — login → Sanctum bearer token
POST /api/v1/auth/demo-login {user_id} — passwordless demo sign-in (test personas)
GET /api/v1/feed/explore — public discovery feed (filter ?country=SN)
GET /api/v1/news — published economic news
GET /api/v1/public/programs — institutional programs & financing (e.g. DER/FJ)
GET /api/v1/public/programs/{program} — program detail + advisors
GET /api/v1/public/starters — starter-friendly opportunities by market
GET /api/v1/events — published events · /events/{slug}
GET /api/v1/pages — pages (commercial faces) · /pages/{page} · /pages/{page}/posts · /items
GET /api/v1/coaches/{page}/ratings — a coach's testimonials + aggregate
GET /api/v1/regions · /industries · /actor-types — reference data
GET /api/v1/search?q=… — cross-surface search · /plans

4. Discovery & opportunities (Sanctum bearer)

GET /api/v1/me — your profile + actor profiles · PATCH /me
GET /api/v1/feed — blended ranked feed (signals, posts, opportunities, news)
GET /api/v1/opportunities — your matched opportunities, ranked, with explanations
GET /api/v1/opportunities/browse · /opportunities/{id} · POST /{id}/dismiss
POST /api/v1/me/opportunity-signals/{signal}/activate — publish a supply signal
GET/POST /api/v1/me/goals — stated objectives that bias matching
GET/POST /api/v1/saved-items · /api/v1/me/notifications

5. Pages, coaches & programs (Sanctum bearer)

GET/POST /api/v1/me/pages · /api/v1/pages — create/manage a commercial face
POST /api/v1/pages/{page}/posts — post as the page · /follows to follow
POST /api/v1/kits/{slug}/ratings · /coaches/{page}/ratings — adopter-gated ratings & testimonials
POST /api/v1/coach-ratings/{id}/respond · /report — coach right-of-reply / moderation
GET/POST /api/v1/pages/{page}/mentor-sessions · /{mentorSession}/book · /{mentorSession}/join — video mentorship
POST /api/v1/pages/{page}/subscribe — subscribe to a coach (free/paid tiers)
POST /api/v1/programs/{program}/apply · /api/v1/me/programs — apply to / track programs

6. Marketplace & deals (Sanctum bearer)

GET/POST /api/v1/listings — supply/demand listings · POST /listings/{listing}/inquiries
POST /api/v1/transactions — offer → /agree → /fulfill → /pay (deal room)
POST /api/v1/forward-contracts — lock a price now → /accept → /fulfill → /settle
POST /api/v1/opportunities/{signal}/bids — bid on an RFQ → /bids/{rfq_bid}/award
GET/POST /api/v1/me/jobs · /api/v1/jobs/{signal}/applicants — hiring
GET/POST /api/v1/me/conversations · /conversations/{user}/messages · /offer

7. Agent & MCP platform

POST /api/v1/agent/clients — register an agent client (verified accounts)
POST /api/v1/me/agents/{agent}/grant — user consent → scoped token
POST /api/v1/agent/oauth/token — exchange client credentials for a scoped Sanctum token
GET /api/v1/agent/tools · POST /api/v1/agent/tools/{tool}/invoke — scope-filtered tool catalog
POST /api/v1/mcp — MCP JSON-RPC 2.0 (initialize / tools/list / tools/call)
GET /api/v1/partner/opportunities — token-gated opportunity syndication (opportunities:read scope)