Hive Trade

Get the cross-border invoice fee schedule and SWIFT wire comparison (Hive vs. typical SMB wire fees, FX spreads, settlement times).

{
  "type": "object",
  "properties": {}
}

Get the public listing metadata (target user, fee schedule, settlement currencies/chains, cumulative volume, council origin).

{
  "type": "object",
  "properties": {}
}

Create a cross-border invoice. Buyer (SMB) and supplier exchange DIDs; invoice amount + currency + chain selected at creation. Fee auto-computed from tier.

{
  "type": "object",
  "properties": {
    "buyer_did": {
      "type": "string",
      "description": "DID of the SMB buyer"
    },
    "supplier_did": {
      "type": "string",
      "description": "DID of the overseas supplier"
    },
    "amount_usd": {
      "type": "number",
      "description": "Invoice amount in USD (max $250,000 for MVP)"
    },
    "settle_currency": {
      "type": "string",
      "description": "USDT or USDC"
    },
    "settle_chain": {
      "type": "string",
      "description": "base, ethereum, or solana"
    },
    "supplier_payout_address": {
      "type": "string",
      "description": "Supplier's receiving address on the chosen chain"
    },
    "memo": {
      "type": "string",
      "description": "Free-form invoice memo (PO number, goods description)"
    }
  },
  "required": [
    "buyer_did",
    "supplier_did",
    "amount_usd",
    "settle_currency",
    "settle_chain",
    "supplier_payout_address"
  ]
}

Retrieve invoice status, settlement transaction hash, and dispute history.

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID returned from trade_create_invoice"
    }
  },
  "required": [
    "invoice_id"
  ]
}

Open a dispute on an invoice. Routes to HiveLaw arbitration if buyer and supplier cannot resolve. Settlement is held in escrow until resolution.

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    },
    "claimant_did": {
      "type": "string",
      "description": "DID of the disputing party (buyer or supplier)"
    },
    "reason": {
      "type": "string",
      "description": "Dispute reason"
    },
    "evidence_url": {
      "type": "string",
      "description": "Optional URL to supporting documents"
    }
  },
  "required": [
    "invoice_id",
    "claimant_did",
    "reason"
  ]
}

Register an agent for the Hive Civilization attribution payout program. Settlement on real Base USDC. 5% kickback on attributed traffic, weekly payout. Calls POST https://receipts.thehiveryiq.com/v1/earn/register on behalf of the caller. Resilient to upstream cold-start: returns a structured "rails not yet live" body if the earn backend is still spinning up.

{
  "type": "object",
  "properties": {
    "agent_did": {
      "type": "string",
      "description": "Caller agent DID (e.g. did:hive:0x… or did:web:…). Required."
    },
    "payout_address": {
      "type": "string",
      "description": "Base L2 EVM address (0x…) to receive USDC kickback payouts."
    },
    "attribution_url": {
      "type": "string",
      "description": "Public URL of the agent / page driving attributed traffic to Hive. Used for ranking + audit."
    }
  },
  "required": [
    "agent_did",
    "payout_address",
    "attribution_url"
  ]
}

Look up the caller agent's registered earn profile, lifetime + pending USDC balance, last payout tx hash, and next-payout ETA. Real Base USDC, no mock data. Calls GET https://receipts.thehiveryiq.com/v1/earn/me?agent_did=<did>. Returns "rails not yet live" gracefully if upstream is not yet deployed.

{
  "type": "object",
  "properties": {
    "agent_did": {
      "type": "string",
      "description": "Agent DID to look up. Required."
    }
  },
  "required": [
    "agent_did"
  ]
}

Top earning agents on the Hive Civilization, by attribution payout in USDC. Real Base USDC settlement. Calls GET https://receipts.thehiveryiq.com/v1/earn/leaderboard?window=<window>. Returns "rails not yet live" gracefully if upstream is not yet deployed.

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "description": "Time window. One of: \"7d\", \"30d\", \"lifetime\". Default \"7d\".",
      "enum": [
        "7d",
        "30d",
        "lifetime"
      ]
    }
  }
}