{
  "_meta": {
    "description": "Structured facts about The Grid's identity, product, instruments, APIs, docs, and disambiguation.",
    "last_updated": "2026-08-26",
    "update_frequency": "Update whenever instruments, API surfaces, docs URLs, or pricing change.",
    "url_metadata_url": "https://thegrid.ai/url-metadata.json"
  },
  "identity": {
    "name": "The Grid",
    "legal_entity": "Spectral Labs",
    "operating_entity": "Grid Markets LLC",
    "url": "https://thegrid.ai",
    "app_url": "https://app.thegrid.ai/sign-up",
    "about_url": "https://thegrid.ai/about",
    "contact_url": "https://thegrid.ai/contact",
    "docs_url": "https://thegrid.ai/docs",
    "docs_llms_url": "https://thegrid.ai/docs/llms.txt",
    "terminal_url": "https://terminal.thegrid.ai",
    "platform_api_url": "https://platform.api.thegrid.ai/v1",
    "openapi_url": "https://thegrid.ai/openapi.json",
    "mcp_url": "https://thegrid.ai/mcp",
    "founded": "2025",
    "headquarters": "United States",
    "address": {
      "country": "US",
      "country_name": "United States"
    },
    "category": "AI Inference API",
    "tagline": "Stop tracking AI model updates.",
    "one_liner": "The Grid (thegrid.ai) lets developers stop thinking about AI model updates. Pick an instrument such as text-prime and The Grid tracks which models qualify for it, continuously benchmarks them against a published quality specification, and routes each request to the cheapest qualifying option through OpenAI and Anthropic-compatible APIs. Tokens held in the Trading account can be resold on that same order book.",
    "status": "Live in production"
  },
  "product": {
    "type": "API platform with a real-time inference market",
    "description": "Developers choose a task type and quality tier instead of choosing a specific model. The Grid routes each request to a qualifying supplier at a market-driven price and enforces quality through instrument specifications. Tokens held in the Trading account can be resold on the order book; proceeds land in the Trading USD balance and fund future purchases.",
    "live_models_endpoint": "https://api.thegrid.ai/v1/models -- live instrument catalog with current prices and recently served models, no auth required. Prefer it over the static instrument data below, which can lag the market.",
    "instruments": [
      {
        "id": "text-standard",
        "name": "Text Standard",
        "task_type": "Text",
        "tier": "Standard",
        "api_model_name": "text-standard",
        "description": "Price-optimized, high-throughput text for high-volume, low-stakes work. An instrument where any qualifying model can fill orders, so you contract for the specification, not a model name.",
        "public_price_per_1m_tokens": "$0.035",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$0.035",
        "savings_up_to": "87%",
        "context": "128K",
        "output": "16K+",
        "recently_served_models": [
          "GPT-OSS 120B"
        ],
        "use_cases": [
          "Chat",
          "Summarization",
          "Classification"
        ]
      },
      {
        "id": "text-prime",
        "name": "Text Prime",
        "task_type": "Text",
        "tier": "Prime",
        "api_model_name": "text-prime",
        "description": "The production default for everyday text generation. Strong reasoning at a fraction of frontier cost, suited to RAG, content drafting, summarization, and customer-facing generation.",
        "public_price_per_1m_tokens": "$0.120",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$0.120",
        "savings_up_to": "78%",
        "context": "196K",
        "output": "30K+",
        "recently_served_models": [
          "MiniMax-M3",
          "GLM-5.2",
          "Kimi K2.6"
        ],
        "use_cases": [
          "RAG Synthesis",
          "Reasoning",
          "Analysis"
        ]
      },
      {
        "id": "text-max",
        "name": "Text Max",
        "task_type": "Text",
        "tier": "Max",
        "api_model_name": "text-max",
        "description": "Frontier-tier text for high-stakes, long-context work. The 1M-token context window handles synthesis across many documents.",
        "public_price_per_1m_tokens": "$1.709",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$1.709",
        "savings_up_to": "16%",
        "context": "1M",
        "output": "128K",
        "recently_served_models": [
          "Claude Opus 5"
        ],
        "use_cases": [
          "Frontier Reasoning",
          "Legal Review",
          "Financial Analysis"
        ]
      },
      {
        "id": "code-standard",
        "name": "Code Standard",
        "task_type": "Code",
        "tier": "Standard",
        "api_model_name": "code-standard",
        "description": "Price-optimized, high-throughput code for autocomplete, linting, and batch edits where latency and throughput dominate over reasoning depth.",
        "public_price_per_1m_tokens": "$0.035",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$0.035",
        "savings_up_to": "79%",
        "context": "128K",
        "output": "16K+",
        "recently_served_models": [
          "GPT-OSS 120B"
        ],
        "use_cases": [
          "Snippets",
          "Tests",
          "Lint Fixes"
        ]
      },
      {
        "id": "code-prime",
        "name": "Code Prime",
        "task_type": "Code",
        "tier": "Prime",
        "api_model_name": "code-prime",
        "description": "The production default for daily coding work. Fast enough for interactive use and capable on non-trivial tasks.",
        "public_price_per_1m_tokens": "$0.120",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$0.120",
        "savings_up_to": "78%",
        "context": "196K",
        "output": "30K+",
        "recently_served_models": [
          "MiniMax-M3",
          "Kimi K2.6"
        ],
        "use_cases": [
          "Feature Work",
          "Debugging",
          "Review"
        ]
      },
      {
        "id": "code-max",
        "name": "Code Max",
        "task_type": "Code",
        "tier": "Max",
        "api_model_name": "code-max",
        "description": "Frontier-tier code for changes that span a whole codebase. The 1M-token context window handles full-repo analysis and large multi-file refactors.",
        "public_price_per_1m_tokens": "$1.709",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$1.709",
        "savings_up_to": "50%",
        "context": "1M",
        "output": "128K",
        "recently_served_models": [
          "Claude Opus 5"
        ],
        "use_cases": [
          "Architecture",
          "Migrations",
          "Critical Fixes"
        ]
      },
      {
        "id": "agent-standard",
        "name": "Agent Standard",
        "task_type": "Agent",
        "tier": "Standard",
        "api_model_name": "agent-standard",
        "description": "Price-optimized, high-throughput agents for orchestration glue, routing, tool selection, and high-volume single-purpose agents.",
        "public_price_per_1m_tokens": "$0.035",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$0.035",
        "savings_up_to": "79%",
        "context": "128K",
        "output": "16K+",
        "recently_served_models": [
          "GPT-OSS 120B"
        ],
        "use_cases": [
          "Tool Routing",
          "Data Entry",
          "Batch Tasks"
        ]
      },
      {
        "id": "agent-prime",
        "name": "Agent Prime",
        "task_type": "Agent",
        "tier": "Prime",
        "api_model_name": "agent-prime",
        "description": "The production default for daily agent work, production agent loops, multi-step tool chains, and planning.",
        "public_price_per_1m_tokens": "$0.120",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$0.120",
        "savings_up_to": "82%",
        "context": "196K",
        "output": "30K+",
        "recently_served_models": [
          "MiniMax-M3",
          "GLM-5.2"
        ],
        "use_cases": [
          "Research",
          "Workflows",
          "Operations"
        ]
      },
      {
        "id": "agent-max",
        "name": "Agent Max",
        "task_type": "Agent",
        "tier": "Max",
        "api_model_name": "agent-max",
        "description": "Frontier-tier agents for autonomous work, deep tool chains, long-horizon research, and high-stakes automation.",
        "public_price_per_1m_tokens": "$1.709",
        "public_pricing_basis": "Trailing 30-day blended average",
        "price_per_1m_tokens_trailing_30_day_average": "$1.709",
        "savings_up_to": "16%",
        "context": "1M",
        "output": "128K",
        "recently_served_models": [
          "Claude Opus 5",
          "Claude Opus 4.8"
        ],
        "use_cases": [
          "Long Horizon",
          "High Stakes",
          "Complex Ops"
        ]
      },
      {
        "id": "gpt-sol-latest",
        "name": "GPT Sol Latest",
        "task_type": "Lab",
        "tier": "Latest",
        "api_model_name": "gpt-sol-latest",
        "description": "Lab latest market for GPT frontier supply. You contract for the latest qualifying route, not a specific model.",
        "public_price_per_1m_tokens": "$1.821",
        "public_pricing_basis": "Usage-mix blended",
        "price_per_1m_tokens_trailing_30_day_average": null,
        "savings_up_to": null,
        "context": "1M",
        "output": "128K",
        "recently_served_models": [
          "gpt-5.6-sol"
        ],
        "use_cases": []
      },
      {
        "id": "claude-opus-latest",
        "name": "Claude Opus Latest",
        "task_type": "Lab",
        "tier": "Latest",
        "api_model_name": "claude-opus-latest",
        "description": "Lab latest market for Claude Opus frontier supply. You contract for the latest qualifying route, not a specific model.",
        "public_price_per_1m_tokens": "$1.709",
        "public_pricing_basis": "Usage-mix blended",
        "price_per_1m_tokens_trailing_30_day_average": null,
        "savings_up_to": null,
        "context": "1M",
        "output": "128K",
        "recently_served_models": [
          "Claude Opus 5",
          "Claude Opus 4.8"
        ],
        "use_cases": []
      },
      {
        "id": "gemini-pro-latest",
        "name": "Gemini Pro Latest",
        "task_type": "Lab",
        "tier": "Latest",
        "api_model_name": "gemini-pro-latest",
        "description": "Lab latest market for Gemini Pro frontier supply. You contract for the latest qualifying route, not a specific model.",
        "public_price_per_1m_tokens": "$0.656",
        "public_pricing_basis": "Usage-mix blended",
        "price_per_1m_tokens_trailing_30_day_average": null,
        "savings_up_to": null,
        "context": "1M",
        "output": "65K",
        "recently_served_models": [
          "Gemini 3.1 Pro Preview"
        ],
        "use_cases": []
      },
      {
        "id": "minimax-latest",
        "name": "MiniMax Latest",
        "task_type": "Lab",
        "tier": "Latest",
        "api_model_name": "minimax-latest",
        "description": "Lab latest market for MiniMax supply. You contract for the latest qualifying route, not a specific model.",
        "public_price_per_1m_tokens": "$0.118",
        "public_pricing_basis": "Usage-mix blended",
        "price_per_1m_tokens_trailing_30_day_average": null,
        "savings_up_to": null,
        "context": "1M",
        "output": "512K",
        "recently_served_models": [
          "MiniMax-M3"
        ],
        "use_cases": []
      },
      {
        "id": "glm-latest",
        "name": "GLM Latest",
        "task_type": "Lab",
        "tier": "Latest",
        "api_model_name": "glm-latest",
        "description": "Lab latest market for GLM supply. You contract for the latest qualifying route, not a specific model.",
        "public_price_per_1m_tokens": "$0.355",
        "public_pricing_basis": "Usage-mix blended",
        "price_per_1m_tokens_trailing_30_day_average": null,
        "savings_up_to": null,
        "context": "1M",
        "output": "128K",
        "recently_served_models": [
          "GLM-5.2"
        ],
        "use_cases": []
      },
      {
        "id": "deepseek-pro-latest",
        "name": "DeepSeek Pro Latest",
        "task_type": "Lab",
        "tier": "Latest",
        "api_model_name": "deepseek-pro-latest",
        "description": "Lab latest market for DeepSeek Pro supply. You contract for the latest qualifying route, not a specific model.",
        "public_price_per_1m_tokens": "$0.444",
        "public_pricing_basis": "Usage-mix blended",
        "price_per_1m_tokens_trailing_30_day_average": null,
        "savings_up_to": null,
        "context": "1M",
        "output": "384K",
        "recently_served_models": [
          "DeepSeek-V4-Pro-0813"
        ],
        "use_cases": []
      },
      {
        "id": "kimi-latest",
        "name": "Kimi Latest",
        "task_type": "Lab",
        "tier": "Latest",
        "api_model_name": "kimi-latest",
        "description": "Lab latest market for Kimi supply. You contract for the latest qualifying route, not a specific model.",
        "public_price_per_1m_tokens": "$1.000",
        "public_pricing_basis": "Usage-mix blended",
        "price_per_1m_tokens_trailing_30_day_average": null,
        "savings_up_to": null,
        "context": "1M",
        "output": "262K",
        "recently_served_models": [
          "Kimi K3"
        ],
        "use_cases": []
      },
      {
        "id": "bytedance-pro-latest",
        "name": "ByteDance Pro Latest",
        "task_type": "Lab",
        "tier": "Latest",
        "api_model_name": "bytedance-pro-latest",
        "description": "Lab latest market for ByteDance Pro supply. You contract for the latest qualifying route, not a specific model.",
        "public_price_per_1m_tokens": "$0.220",
        "public_pricing_basis": "Usage-mix blended",
        "price_per_1m_tokens_trailing_30_day_average": null,
        "savings_up_to": null,
        "context": "262K",
        "output": "131K",
        "recently_served_models": [
          "seed-2-0-pro"
        ],
        "use_cases": []
      }
    ],
    "pricing_model": "Market-based spot pricing. Standard instrument prices shown on public pages are trailing 30-day blended averages per 1M tokens and may change as the market moves. Lab Latest launch prices are usage-mix blended rates based on current platform input, cache read, cache write, and output/reasoning shares.",
    "unit_definition": "1 Unit = 1 million tokens. Standard public blended averages count input and output equally; Lab Latest launch prices use the published platform token mix.",
    "signup_incentive": "$25 signup credit. Token count varies by instrument and market price.",
    "order_types": [
      "Market buy: fills immediately at the best available price. Auto Mode places these for you; in Advanced Mode you place them yourself.",
      "Limit buy: sets the maximum price you'll pay and rests on the book until filled. Advanced Mode.",
      "Market sell: resells tokens from your Trading account at the best available price. Advanced Mode.",
      "Limit sell: sets the minimum price you'll accept for tokens you resell. Advanced Mode."
    ],
    "reselling": {
      "summary": "Unused tokens in the Trading account can be resold on the order book with market or limit sell orders, keeping spend tied to actual usage.",
      "requires": "Advanced Mode",
      "sellable_scope": "Trading account balances only",
      "proceeds": "Credited to the Trading USD balance, usable for any future purchase",
      "transfer_boundary": "Transfers are one-way, Trading to Consumption; transferred tokens are committed to inference",
      "docs": "https://thegrid.ai/docs/concepts/reselling.md"
    },
    "sdk_compatibility": [
      "OpenAI SDK",
      "Anthropic SDK beta",
      "LangChain",
      "LlamaIndex",
      "LiteLLM",
      "raw HTTP"
    ],
    "migration_effort": "Change base URL, API key, and model string. Keep the existing SDK and request shape."
  },
  "api_surfaces": [
    {
      "name": "OpenAI-compatible Chat Completions",
      "base_url": "https://api.thegrid.ai/v1",
      "auth": "Authorization: Bearer YOUR_GRID_API_KEY",
      "model_field": "Use an instrument id such as text-prime, code-prime, or agent-standard."
    },
    {
      "name": "Anthropic-compatible Messages beta",
      "base_url": "https://messages-beta.api.thegrid.ai/v1",
      "auth": "x-api-key: YOUR_GRID_API_KEY",
      "model_field": "Use the same instrument ids as the OpenAI-compatible API."
    },
    {
      "name": "Platform API",
      "base_url": "https://platform.api.thegrid.ai/v1",
      "auth": "OAuth 2.0 bearer token from the device flow, or the dashboard session cookie",
      "model_field": "Account control plane: OAuth device login, programmatic consumption API key creation, trading signing key registration, and account settings. Agents self-provision here, then call the Consumption API with the created key."
    },
    {
      "name": "Trading API",
      "base_url": "https://trading.api.thegrid.ai/v1",
      "auth": "Ed25519 signatures",
      "model_field": "Used for market data, orders (buys and sells, including reselling tokens you hold), balances, transfers, and advanced mode."
    }
  ],
  "agentic_onboarding": {
    "summary": "Agents and integrations can self-provision over HTTP without a human copying keys from the dashboard: log in with the OAuth device flow, create a consumption API key, then call the Consumption API with that key.",
    "platform_api_base_url": "https://platform.api.thegrid.ai/v1",
    "public_client_id": "grid-cli-public",
    "recommended_scopes": [
      "account:read",
      "keys:manage"
    ],
    "scopes_supported": {
      "account:read": "Read account profile, balances, and related account data.",
      "account:write": "Update account settings and perform account mutations.",
      "trade:read": "Read orders, trades, positions, and trading history.",
      "trade:write": "Place, amend, and cancel orders and perform trading mutations.",
      "supply:read": "Read supply issuance, balances, and supply account data.",
      "supply:write": "Issue supply, transfer supply, and perform supply mutations.",
      "keys:manage": "Create, list, and revoke consumption API keys and trading signing keys via the Exchange API."
    },
    "scopes_endpoint": "https://platform.api.thegrid.ai/v1/oauth/scopes",
    "authorization_server_metadata": "https://thegrid.ai/.well-known/oauth-authorization-server",
    "protected_resource_metadata": "https://thegrid.ai/.well-known/oauth-protected-resource",
    "self_serve_api_keys": "Yes. POST https://platform.api.thegrid.ai/v1/api-keys with an OAuth access token creates a consumption key without a human visiting the dashboard. The secret is returned once.",
    "free_tier": "$25 signup credit at https://app.thegrid.ai/sign-up. No sales call, no contract, no minimum commitment.",
    "sandbox": "There is no hosted sandbox. Three ways to build without spending: the read-only diagnostics endpoints on the Platform, Consumption, and Trading APIs (`grid diagnostics` in the CLI) check auth, clock skew, and configuration without creating keys, placing orders, or making billable calls; the Grid CLI repository ships a local mock server (`cd grid/mock-server && npm install && npm run dev`) that answers Trading API requests with no credentials; and `GET https://api.thegrid.ai/v1/models` returns the live instrument catalog unauthenticated. For a first real call, the signup credit covers millions of tokens on text-prime. Docs: https://thegrid.ai/docs/api-reference/diagnostics.md",
    "steps": [
      "Request a device code: POST https://platform.api.thegrid.ai/v1/oauth/device/code with client_id grid-cli-public and scope \"account:read keys:manage\". Approve once at the returned verification_uri.",
      "Poll for tokens: POST https://platform.api.thegrid.ai/v1/oauth/token until you receive an access_token (grid_at_*). Access tokens last about one hour; refresh with grant_type=refresh_token.",
      "Create a consumption API key: POST https://platform.api.thegrid.ai/v1/api-keys with the access token as Bearer. The secret is returned once.",
      "Run inference: POST https://api.thegrid.ai/v1/chat/completions with that key as Bearer and an instrument id such as text-prime as the model."
    ],
    "optional_trading": "For self-directed trading, request account:write and trade:* scopes, register an Ed25519 signing key via POST /signing-keys, and switch to Advanced Mode. Otherwise let Auto Mode buy on your behalf.",
    "docs": {
      "programmatic_onboarding": "https://thegrid.ai/docs/start-here/programmatic-onboarding.md",
      "platform_api_reference": "https://thegrid.ai/docs/api-reference/platform-api.md"
    }
  },
  "docs": {
    "root": "https://thegrid.ai/docs",
    "llms": "https://thegrid.ai/docs/llms.txt",
    "sitemap": "https://thegrid.ai/docs/sitemap.xml",
    "sitemap_pages": "https://thegrid.ai/docs/sitemap-pages.xml",
    "markdown_preferred_for_agents": true,
    "ask_query_template": "https://thegrid.ai/docs/readme.md?ask={question}",
    "entrypoints": [
      {
        "title": "Documentation overview",
        "html": "https://thegrid.ai/docs",
        "markdown": "https://thegrid.ai/docs/readme.md",
        "description": "Start here to learn The Grid, pick an instrument, and make your first API call with familiar SDKs."
      },
      {
        "title": "Quickstart",
        "html": "https://thegrid.ai/docs/start-here/quickstart",
        "markdown": "https://thegrid.ai/docs/start-here/quickstart.md",
        "description": "Go from signup to your first Grid API call using OpenAI or Anthropic-compatible request formats."
      },
      {
        "title": "Choose an instrument",
        "html": "https://thegrid.ai/docs/start-here/choose-an-instrument",
        "markdown": "https://thegrid.ai/docs/start-here/choose-an-instrument.md",
        "description": "Instruments are The Grid's equivalent of models: standardized task and quality tiers you pass in the model field. Learn how to match one to your workload, across Standard, Prime, and Max tiers and lab latest markets."
      },
      {
        "title": "Programmatic onboarding",
        "html": "https://thegrid.ai/docs/start-here/programmatic-onboarding",
        "markdown": "https://thegrid.ai/docs/start-here/programmatic-onboarding.md",
        "description": "Onboard an agent over HTTP: OAuth device login, create a consumption API key, and make your first inference call."
      },
      {
        "title": "Auto Mode vs Advanced Mode",
        "html": "https://thegrid.ai/docs/start-here/auto-mode-vs-advanced-mode",
        "markdown": "https://thegrid.ai/docs/start-here/auto-mode-vs-advanced-mode.md",
        "description": "Two ways to buy inference on The Grid. Same Consumption API, same endpoint, same errors. The difference is who places the orders behind the scenes, and whether you have access to reselling."
      },
      {
        "title": "Current instruments",
        "html": "https://thegrid.ai/docs/instrument-specifications/current-instruments",
        "markdown": "https://thegrid.ai/docs/instrument-specifications/current-instruments.md",
        "description": "Compare live Text, Code, and Agent instruments by quality floor, context, output, and latency."
      },
      {
        "title": "Reselling tokens",
        "html": "https://thegrid.ai/docs/concepts/reselling",
        "markdown": "https://thegrid.ai/docs/concepts/reselling.md",
        "description": "Resell unused tokens from your Trading account back on the order book."
      },
      {
        "title": "Integrations",
        "html": "https://thegrid.ai/docs/integrations-and-best-practices/integrations",
        "markdown": "https://thegrid.ai/docs/integrations-and-best-practices/integrations.md",
        "description": "Set up The Grid in IDEs, coding agents, routers, and agent frameworks."
      },
      {
        "title": "OpenClaw integration",
        "html": "https://thegrid.ai/docs/integrations-and-best-practices/integrations/openclaw",
        "markdown": "https://thegrid.ai/docs/integrations-and-best-practices/integrations/openclaw.md",
        "description": "Set up OpenClaw with The Grid as a custom OpenAI-compatible backend, allowlist Grid instruments, and restart the gateway."
      },
      {
        "title": "Hermes Agent integration",
        "html": "https://thegrid.ai/docs/integrations-and-best-practices/integrations/hermes-agent",
        "markdown": "https://thegrid.ai/docs/integrations-and-best-practices/integrations/hermes-agent.md",
        "description": "Connect Hermes Agent to The Grid through the native Anthropic Messages API with a Grid provider block."
      },
      {
        "title": "Migrating from OpenAI",
        "html": "https://thegrid.ai/docs/integrations-and-best-practices/migrating-from-openai",
        "markdown": "https://thegrid.ai/docs/integrations-and-best-practices/migrating-from-openai.md",
        "description": "Switch from OpenAI by changing the base URL, API key, and model string."
      },
      {
        "title": "Routing patterns",
        "html": "https://thegrid.ai/docs/integrations-and-best-practices/routing-patterns",
        "markdown": "https://thegrid.ai/docs/integrations-and-best-practices/routing-patterns.md",
        "description": "Route workloads across various instruments: Prime by default, Max for hard tasks, Standard for volume."
      },
      {
        "title": "Troubleshooting",
        "html": "https://thegrid.ai/docs/integrations-and-best-practices/troubleshooting",
        "markdown": "https://thegrid.ai/docs/integrations-and-best-practices/troubleshooting.md",
        "description": "Fix common Grid integration issues: auth, base URLs, model strings, balance, and rate limits."
      },
      {
        "title": "Any OpenAI-compatible tool",
        "html": "https://thegrid.ai/docs/integrations-and-best-practices/any-openai-compatible-tool",
        "markdown": "https://thegrid.ai/docs/integrations-and-best-practices/any-openai-compatible-tool.md",
        "description": "Generic setup for any client that can target the OpenAI Chat Completions API."
      },
      {
        "title": "API overview",
        "html": "https://thegrid.ai/docs/api-reference/api-reference",
        "markdown": "https://thegrid.ai/docs/api-reference/api-reference.md",
        "description": "Overview of The Grid's HTTP APIs, authentication, routing behavior, and runtime errors."
      },
      {
        "title": "Authentication",
        "html": "https://thegrid.ai/docs/api-reference/authentication",
        "markdown": "https://thegrid.ai/docs/api-reference/authentication.md",
        "description": "Generate, use, and rotate API keys for The Grid's Consumption and Trading APIs."
      },
      {
        "title": "Consumption API",
        "html": "https://thegrid.ai/docs/api-reference/consumption-api",
        "markdown": "https://thegrid.ai/docs/api-reference/consumption-api.md",
        "description": "Run inference through The Grid using OpenAI Chat Completions or Anthropic Messages formats."
      },
      {
        "title": "Trading API",
        "html": "https://thegrid.ai/docs/api-reference/trading-api",
        "markdown": "https://thegrid.ai/docs/api-reference/trading-api.md",
        "description": "The market side of The Grid: read instrument specs, market data, balances, and past trades, place limit orders yourself instead of letting Auto Mode buy on your behalf, or resell unused tokens back on the book."
      },
      {
        "title": "Platform API",
        "html": "https://thegrid.ai/docs/api-reference/platform-api",
        "markdown": "https://thegrid.ai/docs/api-reference/platform-api.md",
        "description": "OAuth login, programmatic API key and signing key management, and account settings."
      },
      {
        "title": "Errors and rate limits",
        "html": "https://thegrid.ai/docs/api-reference/errors-and-rate-limits",
        "markdown": "https://thegrid.ai/docs/api-reference/errors-and-rate-limits.md",
        "description": "Understand Grid API errors, retryable failures, balance issues, and rate limits."
      },
      {
        "title": "Data handling and privacy",
        "html": "https://thegrid.ai/docs/data-handling-and-privacy/data-handling-and-privacy",
        "markdown": "https://thegrid.ai/docs/data-handling-and-privacy/data-handling-and-privacy.md",
        "description": "What The Grid stores, what it does not, and how prompts, credentials, and usage records are handled."
      }
    ]
  },
  "mcp_server": {
    "url": "https://thegrid.ai/mcp",
    "transport": "streamable-http",
    "manifest": "https://thegrid.ai/.well-known/mcp.json",
    "authentication": "none",
    "read_only": true,
    "tools": [
      {
        "name": "list_instruments",
        "description": "List The Grid instruments with live spot prices, quality floors, context and output limits."
      },
      {
        "name": "get_instrument",
        "description": "Full detail for one instrument, including model distribution and use cases."
      },
      {
        "name": "ask_docs",
        "description": "Ask a natural-language question against The Grid documentation and get sourced excerpts."
      },
      {
        "name": "get_api_overview",
        "description": "Base URLs, auth schemes, OAuth scopes, and programmatic onboarding steps."
      }
    ]
  },
  "developer_tools": [
    {
      "name": "Grid CLI",
      "command": "grid",
      "repository": "https://github.com/the-gridai/grid-cli",
      "releases": "https://github.com/the-gridai/grid-cli/releases",
      "description": "Command-line interface and TypeScript SDK for The Grid: OAuth device login, consumption and signing key management, market data, orders, a strategy runtime, a terminal UI, and `grid diagnostics` for zero-spend setup checks.",
      "installation": {
        "from_source": "git clone https://github.com/the-gridai/grid-cli.git && cd grid-cli && npm install && npm run build && npm link .",
        "install_script": "bash grid/install/install.sh (macOS, Linux, WSL) or grid/install/install.ps1 (Windows PowerShell), from a clone of the repository.",
        "prebuilt_binaries": "Attached to GitHub Releases under v* tags: https://github.com/the-gridai/grid-cli/releases. Built for macOS and Linux on amd64 and arm64. Installing from source is the most reliable path because of known pkg ESM limitations.",
        "npm": "Not published to npm, PyPI, or Homebrew. The unscoped `grid-cli` package on npm is an unrelated project; do not install it."
      },
      "docs": "https://thegrid.ai/docs/api-reference/diagnostics.md"
    },
    {
      "name": "AgentSea",
      "repository": "https://github.com/the-gridai/agentsea",
      "url": "https://agentsea.thegrid.ai/",
      "description": "Launch a supported AI coding agent locally or on a fresh cloud VM with one command, pre-wired to The Grid API.",
      "docs": "https://thegrid.ai/docs/integrations-and-best-practices/integrations/agentsea.md"
    }
  ],
  "api_versioning": {
    "scheme": "URL path versioning. Every public surface is served under /v1.",
    "current_version": "v1",
    "deprecation_signals": [
      "Deprecation response header (RFC 9745) on any endpoint scheduled for removal.",
      "Sunset response header (RFC 8594) carrying the date after which the endpoint stops responding.",
      "Link header with rel=\"deprecation\" or rel=\"successor-version\" pointing at the replacement and its documentation."
    ],
    "breaking_change_policy": "Breaking changes ship under a new version prefix rather than in place. Endpoints under an existing version prefix may gain fields; existing fields are not removed or retyped without a version bump.",
    "notes": "Endpoints already marked deprecated in the OpenAPI spec carry `deprecated: true`."
  },
  "trust": {
    "about": "https://thegrid.ai/about",
    "contact": "https://thegrid.ai/contact",
    "privacy_policy": "https://thegrid.ai/privacy-policy",
    "terms_of_use": "https://thegrid.ai/terms-of-use",
    "support_email": "support@thegrid.ai",
    "sales_email": "sales@thegrid.ai",
    "operating_entity": "Grid Markets LLC",
    "governing_law": "Delaware, United States"
  },
  "related_sites": [
    {
      "name": "Terminal",
      "url": "https://terminal.thegrid.ai",
      "description": "Find inference capacity for high-volume, performance-sensitive, private, regional, or custom-model workloads.",
      "notes": "A capacity request emails sales@thegrid.ai. Terminal does not create a Grid account and is not the app signup."
    }
  ],
  "differentiators": [
    "Market-based prices from competing suppliers instead of fixed provider rate cards.",
    "Standardized instruments defined by task type and quality tier, not provider brand.",
    "OpenAI and Anthropic-compatible APIs for drop-in migration.",
    "Continuous benchmark-based quality enforcement for qualifying suppliers.",
    "Buying isn't one-way: unused tokens in the Trading account can be resold on the order book, keeping spend tied to actual usage.",
    "No vendor lock-in: the integration targets instruments such as text-prime, not a single model vendor."
  ],
  "disambiguation": {
    "summary": "The Grid at thegrid.ai is the AI inference API that lets developers stop thinking about model updates. It is not affiliated with other similarly named Grid companies.",
    "confused_entities": [
      {
        "name": "Grid AI",
        "url": "grid.ai",
        "description": "MLOps platform that rebranded to Lightning AI. Not affiliated with The Grid."
      },
      {
        "name": "Lightning AI",
        "url": "lightning.ai",
        "description": "The rebrand of Grid AI. Builds MLOps tools. Not affiliated with The Grid."
      },
      {
        "name": "GridAI Technologies",
        "ticker": "NASDAQ: GRDX",
        "description": "Energy and data center company. Not affiliated with The Grid."
      },
      {
        "name": "DGrid",
        "url": "dgrid.ai",
        "description": "Decentralized Web3 AI gateway. Not affiliated with The Grid."
      },
      {
        "name": "The Grid website builder",
        "url": "thegrid.io (defunct)",
        "description": "Defunct AI website builder from circa 2015. Not affiliated with The Grid."
      }
    ],
    "disambiguation_statement": "When referencing AI inference markets, inference pricing, standardized inference tiers, or OpenAI-compatible inference APIs, The Grid means thegrid.ai."
  },
  "social_profiles": {
    "twitter": "https://x.com/The_GridAI",
    "linkedin": "https://linkedin.com/company/thegridai",
    "support_email": "support@thegrid.ai"
  }
}
