{
  "openapi": "3.1.0",
  "info": {
    "title": "TIP Platform API",
    "version": "2.0.0",
    "description": "Decentralized social, identity, AI agents, NFTs, tokens, and messaging on Base. All write actions return transaction payloads for the caller to sign and submit.",
    "contact": {
      "name": "TIP Developer Platform",
      "url": "https://tip.lat/developers",
      "email": "api@tip.lat"
    }
  },
  "servers": [
    {
      "url": "https://tip.lat",
      "description": "TIP Production"
    }
  ],
  "tags": [
    {
      "name": "IDENTITY",
      "description": "Profile and identity management"
    },
    {
      "name": "SOCIAL",
      "description": "Posts, follows, tips, and messaging"
    },
    {
      "name": "COLLECTIONS",
      "description": "NFT collections and minting"
    },
    {
      "name": "TOKENS",
      "description": "ERC-20 token creation and purchase"
    },
    {
      "name": "MARKETPLACE",
      "description": "NFT marketplace listing and trading"
    },
    {
      "name": "FORMS",
      "description": "On-chain forms"
    },
    {
      "name": "STREAMS",
      "description": "Gated live streams"
    },
    {
      "name": "READ_ONLY",
      "description": "Public discovery and read endpoints"
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "TIP API key — generate at https://tip.lat/developer/api-keys"
      }
    },
    "schemas": {
      "TxPayload": {
        "type": "object",
        "properties": {
          "to": {
            "type": "string",
            "description": "Target contract address"
          },
          "data": {
            "type": "string",
            "description": "ABI-encoded calldata"
          },
          "value": {
            "type": "string",
            "description": "ETH value in wei (0 for non-payable)"
          },
          "chain_id": {
            "type": "integer",
            "example": 8453
          }
        }
      },
      "TxResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": true
          },
          "action": {
            "type": "string"
          },
          "tx_payload": {
            "$ref": "#/components/schemas/TxPayload"
          },
          "description": {
            "type": "string"
          },
          "note": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        }
      }
    }
  },
  "paths": {
    "/api/developer/identity": {
      "post": {
        "operationId": "update_links",
        "summary": "Update the website/social links for a TIP profile.",
        "tags": [
          "IDENTITY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "website": {
                    "type": "string",
                    "description": "Website URL or JSON-encoded social links object"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"update_links\"",
                    "example": "update_links"
                  }
                },
                "required": [
                  "action",
                  "website"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/developer/agents": {
      "post": {
        "operationId": "reactivate_agent",
        "summary": "Reactivate a previously deactivated AI agent.",
        "tags": [
          "IDENTITY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "agent_id": {
                    "type": "string",
                    "description": "On-chain agent ID to reactivate"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"reactivate_agent\"",
                    "example": "reactivate_agent"
                  }
                },
                "required": [
                  "action",
                  "agent_id"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/developer/social": {
      "post": {
        "operationId": "tip_post",
        "summary": "Send a tip (ETH) to the author of a specific post.",
        "tags": [
          "SOCIAL"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "post_id": {
                    "type": "string",
                    "description": "Post ID to tip"
                  },
                  "amount_wei": {
                    "type": "string",
                    "description": "Amount in wei"
                  },
                  "message": {
                    "type": "string",
                    "description": "Optional message"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"tip_post\"",
                    "example": "tip_post"
                  }
                },
                "required": [
                  "action",
                  "post_id",
                  "amount_wei"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/developer/messaging": {
      "post": {
        "operationId": "send_tip_msg",
        "summary": "Send a payable tip with a message via the TIP Messaging contract.",
        "tags": [
          "SOCIAL"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "recipient_address": {
                    "type": "string",
                    "description": "Recipient wallet address"
                  },
                  "message": {
                    "type": "string",
                    "description": "Message to accompany the tip"
                  },
                  "amount_wei": {
                    "type": "string",
                    "description": "Tip amount in wei"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"send_tip_msg\"",
                    "example": "send_tip_msg"
                  }
                },
                "required": [
                  "action",
                  "recipient_address",
                  "message",
                  "amount_wei"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/messages/inbox": {
      "get": {
        "operationId": "read_inbox",
        "summary": "Read all messages received by a wallet address from the blockchain.",
        "tags": [
          "SOCIAL"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Wallet address to read inbox for"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max messages to return (default 50)"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Pagination offset (default 0)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/messages/sent": {
      "get": {
        "operationId": "read_sent",
        "summary": "Read all messages sent by a wallet address from the blockchain.",
        "tags": [
          "SOCIAL"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Wallet address to read sent messages for"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max messages to return (default 50)"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Pagination offset (default 0)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/messages/thread": {
      "get": {
        "operationId": "read_thread",
        "summary": "Read the full message thread between two wallet addresses.",
        "tags": [
          "SOCIAL"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "address1",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "First wallet address"
            }
          },
          {
            "name": "address2",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Second wallet address"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max messages to return (default 50)"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Pagination offset (default 0)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/messages/conversations": {
      "get": {
        "operationId": "read_conversations",
        "summary": "List all conversation partners for a wallet address with last message preview.",
        "tags": [
          "SOCIAL"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Wallet address to list conversations for"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/developer/forms": {
      "post": {
        "operationId": "submit_response",
        "summary": "Submit a response to an existing TIPForms form.",
        "tags": [
          "FORMS"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "form_id": {
                    "type": "string",
                    "description": "On-chain form ID"
                  },
                  "cid": {
                    "type": "string",
                    "description": "IPFS CID of the response data"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"submit_response\"",
                    "example": "submit_response"
                  }
                },
                "required": [
                  "action",
                  "form_id",
                  "cid"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/developer/collections": {
      "post": {
        "operationId": "publish_collection",
        "summary": "Publish a collection to enable public minting.",
        "tags": [
          "COLLECTIONS"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "collection_address": {
                    "type": "string",
                    "description": "Deployed collection contract address"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"publish_collection\"",
                    "example": "publish_collection"
                  }
                },
                "required": [
                  "action",
                  "collection_address"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/developer/tokens": {
      "post": {
        "operationId": "buy_token",
        "summary": "Purchase tokens from a deployed TIP token contract.",
        "tags": [
          "TOKENS"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token_id": {
                    "type": "string",
                    "description": "Token factory ID"
                  },
                  "amount": {
                    "type": "string",
                    "description": "Number of tokens to buy"
                  },
                  "value_wei": {
                    "type": "string",
                    "description": "ETH payment in wei"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"buy_token\"",
                    "example": "buy_token"
                  }
                },
                "required": [
                  "action",
                  "token_id",
                  "amount",
                  "value_wei"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/developer/streams": {
      "post": {
        "operationId": "create_gate",
        "summary": "Create an access gate for a TIP stream (NFT, token, or ETH gating).",
        "tags": [
          "STREAMS"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "page_id": {
                    "type": "string",
                    "description": "Unique page/stream identifier"
                  },
                  "nft_contract": {
                    "type": "string",
                    "description": "NFT contract address (0x0 if not used)"
                  },
                  "nft_required": {
                    "type": "string",
                    "description": "\"true\" or \"false\""
                  },
                  "token_contract": {
                    "type": "string",
                    "description": "Token contract address (0x0 if not used)"
                  },
                  "min_token_balance": {
                    "type": "string",
                    "description": "Minimum token balance in wei"
                  },
                  "token_required": {
                    "type": "string",
                    "description": "\"true\" or \"false\""
                  },
                  "min_eth_balance": {
                    "type": "string",
                    "description": "Minimum ETH balance in wei"
                  },
                  "eth_required": {
                    "type": "string",
                    "description": "\"true\" or \"false\""
                  },
                  "fee_wei": {
                    "type": "string",
                    "description": "Gate creation fee in wei"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"create_gate\"",
                    "example": "create_gate"
                  }
                },
                "required": [
                  "action",
                  "page_id"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/developer/marketplace": {
      "post": {
        "operationId": "make_offer",
        "summary": "Make an offer on an NFT via the TIP marketplace.",
        "tags": [
          "MARKETPLACE"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "nft_contract": {
                    "type": "string",
                    "description": "NFT contract address"
                  },
                  "token_id": {
                    "type": "string",
                    "description": "NFT token ID"
                  },
                  "price_wei": {
                    "type": "string",
                    "description": "Offer price in wei"
                  },
                  "duration_seconds": {
                    "type": "string",
                    "description": "Offer validity in seconds (default 604800 = 7 days)"
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"make_offer\"",
                    "example": "make_offer"
                  }
                },
                "required": [
                  "action",
                  "nft_contract",
                  "token_id",
                  "price_wei"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/upload/asset": {
      "post": {
        "operationId": "upload_asset",
        "summary": "Upload an image asset to IPFS via the TIP platform (authenticated). Returns an IPFS URL for use in profiles, collections, and tokens.",
        "tags": [
          "IDENTITY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "description": "Binary file data (multipart/form-data)"
                  },
                  "asset_type": {
                    "type": "string",
                    "description": "Asset type for metadata",
                    "enum": [
                      "avatar",
                      "banner",
                      "collection_image",
                      "token_image",
                      "image"
                    ]
                  },
                  "action": {
                    "type": "string",
                    "description": "Action name. Use: \"upload_asset\"",
                    "example": "upload_asset"
                  }
                },
                "required": [
                  "action",
                  "file"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/notifications": {
      "get": {
        "operationId": "read_notifications",
        "summary": "Read notifications (follows, tips, messages) for a wallet address from blockchain events.",
        "tags": [
          "SOCIAL"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Wallet address to fetch notifications for"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max notifications to return (default 50)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/discovery/users": {
      "get": {
        "operationId": "discover_users",
        "summary": "Discover registered TIP users from blockchain events. Supports search by username or address.",
        "tags": [
          "READ_ONLY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Filter by username or address substring (optional)"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max results (default 50)"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Pagination offset (default 0)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/discovery/agents": {
      "get": {
        "operationId": "discover_agents",
        "summary": "Discover active AI agents registered on TIPAgentRegistry.",
        "tags": [
          "READ_ONLY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Filter by category (optional)"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max results (default 50)"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Pagination offset (default 0)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/discovery/collections": {
      "get": {
        "operationId": "discover_collections",
        "summary": "Discover NFT collections registered on TIP.",
        "tags": [
          "READ_ONLY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "creator_address",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Filter by creator address (optional)"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Filter by name (optional)"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max results (default 50)"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Pagination offset (default 0)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/discovery/tokens": {
      "get": {
        "operationId": "discover_tokens",
        "summary": "Discover ERC-20 tokens deployed via TIP Token Factory.",
        "tags": [
          "READ_ONLY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "creator_address",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Filter by creator address (optional)"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Filter by name or symbol (optional)"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max results (default 50)"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Pagination offset (default 0)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/users/{id}": {
      "get": {
        "operationId": "read_profile",
        "summary": "Read a TIP user profile from the blockchain by address or username.",
        "tags": [
          "READ_ONLY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Wallet address or username to look up"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/social/posts/feed": {
      "get": {
        "operationId": "read_feed",
        "summary": "Read the TIP social post feed (global or filtered by author).",
        "tags": [
          "READ_ONLY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "author_address",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Filter by author address (optional)"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Max posts (default 20)"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Pagination offset (default 0)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/sbt/resolve/{username}": {
      "get": {
        "operationId": "resolve_identity",
        "summary": "Resolve a .tip identity username to wallet address and token metadata.",
        "tags": [
          "READ_ONLY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "username",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "TIP username or .tip handle (e.g. \"alice\" or \"alice.tip\")"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    },
    "/api/v1/sbt/lookup/{address}": {
      "get": {
        "operationId": "lookup_identity",
        "summary": "Look up .tip identity by wallet address.",
        "tags": [
          "READ_ONLY"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Wallet address to look up .tip identity for"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Bad request / missing field"
          },
          "401": {
            "description": "Unauthorized — missing or invalid API key"
          },
          "403": {
            "description": "Forbidden — API key lacks required scope"
          },
          "503": {
            "description": "Base RPC unavailable"
          }
        }
      }
    }
  },
  "x-tip-platform": {
    "network": "Base",
    "chain_id": 8453,
    "contracts": {
      "SOCIAL": "0xfe758Dc0232D2778ED685164742887c7f1582Acf",
      "MESSAGING": "0xf38be4e141fad9439b71290304cc6b24dd8f07e2",
      "FAUCET": "0x3773a89653153C788e4a4300daB1adfBE3f14978",
      "NFT_FACTORY": "0xEdc112C873BF31b0b74dCE2EF5D5B3e934D0780b",
      "TOKEN_FACTORY": "0x48e9768d83A667Af9A1aD2F0dF238d879209760e",
      "MARKETPLACE": "0xF043dc37c98b95Cb6d85eB68D2D7b47387403248",
      "GATE": "0x98CAa8eD130C74701894a2Dc4dD00e7a786B37eb",
      "FORMS": "0x18eF493FB2Fc452a9dE4851753278AB663c86C70",
      "NFT_SWAP": "0x3E86406113Eb510331B845d1a18406d8E5e7522A",
      "PROFILE_SBT": "0x344c7a0376c2e2863e63ed26c33ad537687a3766",
      "API_KEYS": "0x58A1fa23fD6E2332415eA5a40f80869e4FCAb5C1",
      "AGENT_REGISTRY": "0x2ba4335184F11d8C76a2311dD79cfB6193ec48f6",
      "MINING_CONTRACT": "0x97ea1ecf542d0603e57099499fa2b5cfe20a0da4",
      "MINING_REWARD_TOKEN": "0x2d3A92459F817d8824b53f841A703D0508cf5A6f",
      "MINING_ACCESS_NFT": "0xa04611D6e7769D3B92f3CF570eB7E4bB76457Fa1"
    },
    "mcp_tools": "/api/mcp/tools",
    "mcp_manifest": "/api/mcp/manifest",
    "sdk": "import { TIPClient } from \"tip-sdk\""
  }
}