> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.tradespace.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.tradespace.io/_mcp/server.

# Welcome

> Read Tradespace data from your own systems with the public GraphQL API.

The Tradespace public API is a read-only GraphQL API. Every request is a `POST` to the `/graphql` endpoint of your account's region:

| Region        | Tradespace app         | API endpoint                           |
| ------------- | ---------------------- | -------------------------------------- |
| United States | `app.tradespace.io`    | `https://api.tradespace.io/graphql`    |
| Europe        | `app.eu.tradespace.io` | `https://api.eu.tradespace.io/graphql` |
| Canada        | `app.ca.tradespace.io` | `https://api.ca.tradespace.io/graphql` |
| Asia Pacific  | `app.ap.tradespace.io` | `https://api.ap.tradespace.io/graphql` |

Use the endpoint that matches the address you sign in to. API keys only work in the region where they were created.

Use the API to read agreements, assignees, contacts, deals, disclosures, filings, grants, iEdison reports, ideas, opportunities, organizations, patents, products, and todos for your account.

## Your first request

Every request needs an API key and a named operation.

```bash
curl https://api.tradespace.io/graphql \
  -H "Authorization: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "operationName": "RecentDisclosures",
    "query": "query RecentDisclosures { disclosures(limit: 5) { collection { id disclosureNumber title } metadata { totalCount } } }"
  }'
```

#### [Authentication](/home/get-started/authentication)

Create an API key and send it with every request.

#### [Finding records](/home/get-started/finding-records)

Look up records by ID, number, or patent number.

#### [Pagination and sorting](/home/get-started/pagination)

Page through list queries and change their order.

#### [Errors](/home/get-started/errors)

HTTP statuses and GraphQL errors the API returns.

#### [Rate limits](/home/get-started/rate-limits)

Hourly request limits per account.

#### [API Reference](/api-reference)

Browse every query, argument, and type.