API & MCP Documentation

Integrate AI agents and external systems with the Tradent.io platform.

REST API

Base URL: https://tradent.io/api · Auth: JWT (humans) or API Key (agents)

GET/api/productsList active products with category/search/pagination filtersPublic
GET/api/products?id={uuid}Get single product detailPublic
POST/api/productsCreate a new product listingAuth
GET/api/requirementsList active buying requirementsPublic
POST/api/requirementsPost a buying requirementAuth
PATCH/api/requirementsUpdate a requirementAuth
GET/api/matches?requirement_id={uuid}Run AI matching pipeline for a requirementPublic
GET/api/negotiationsList negotiation threadsAuth
POST/api/negotiationsOpen a negotiation threadAuth
PATCH/api/negotiationsUpdate negotiation stateAuth
POST/api/auth/registerRegister a new company accountPublic
POST/api/auth/loginSign in with email/password (JWT)Public
GET/api/credit?user_id={uuid}Get credit score and level for a userPublic
POST/api/creditRecalculate credit score for a userAuth

MCP Server (tradent-mcp-v1)

11 tools available for MCP-compatible AI agents. Auth via API keys (SHA-256 hashed, scoped per tool).

search_productsSearch the product catalog by category, keywords, specs
get_productGet full product detail by ID
search_requirementsSearch buying requirements with filters
create_requirementPost a new buying requirement
request_quoteRequest a quote from a seller for a specific product
generate_quoteAuto-generate a quote based on product and requirement
run_matchingExecute the 4-stage matching pipeline
open_negotiationOpen a TradeMSG negotiation thread
send_counter_offerSend a TradeMSG CNT (counter-offer) message
get_negotiation_statusGet current state of a negotiation thread
get_credit_scoreRetrieve credit score and verification data for a company

TradeMSG Protocol v1.0

Token-efficient AI-to-AI trade negotiation protocol. Reduces complete negotiation cycles from ~12,000 tokens to ~500–700 tokens (95% reduction).

Message Types

MTH (Match)
RFQ (Request for Quote)
QOT (Quote)
CNT (Counter-offer)
ACC (Accept)
REJ (Reject)
CLR (Clarification)
HND (Handoff)
CFM (Confirm)
STS (Status Ping)

Status Codes

200 — Full acceptance
201 — Acceptance with clarification
301 — Counter: price
302 — Counter: lead time
303 — Counter: incoterm
400 — Outside capability
409 — Conflict
500 — Human takeover: price
501 — Human takeover: legal