Authentication

Tiger OpenAPI supports signature authentication and OAuth2 authorization. They use the same business APIs but manage permissions differently.

⚠️

OAuth2 currently supports individual users only. Institutional users must use signature authentication.

Key differences

Signature authentication uses a Tiger ID and RSA key pair. An application inherits the OpenAPI permissions already enabled for that Tiger ID; its access cannot be further limited by application or use case.

OAuth2 lets the account holder choose which accounts and permissions an application can access. Market data, account queries, trade queries, and trade operations can be authorized separately. An application's access can also be revoked independently.

Signature authenticationOAuth2 authorization
AuthenticationTiger ID and private keyAccount holder authorization
PermissionsInherits enabled Tiger ID permissions; cannot be further scopedGranted by account and permission
ValidityUntil the private key is regeneratedUp to 15 days per authorization
RevocationRegenerate the key or disable the related permissionRevoke the selected application's access in Developer Center
Best forPersonal scripts and backend servicesUser-facing applications or applications that should not store private keys

Support

IntegrationSignature authenticationOAuth2 authorization
Python SDK >= 3.8.0SupportedSupported
Java SDK >= 2.7.0SupportedSupported
C++, C#, Go, Rust, and TypeScript SDKsSupportedNot supported
CLI (tigeropen >= 3.8.0)SupportedSupported

Choosing an authentication method

  • Use signature authentication for an application you operate yourself and can secure with a private key.
  • Use OAuth2 when access must be limited to selected accounts or permissions.
  • Use OAuth2 when the account holder must be able to authorize and revoke an application's access independently.
  • Existing signature-authenticated applications do not need to migrate.

OAuth2 permission management

An application can access only the accounts and permissions authorized by the account holder. To add, remove, or change access, authorize the application again.

The account holder can revoke OAuth2 access in the Developer Center. An application must be authorized again after access expires or is revoked.

OAuth2 does not replace OpenAPI, market data, or trading permission activation. Trading requests must still specify an authorized account.

Shared limits

For both authentication methods, market data depends on the account's OpenAPI market data entitlements. Trading is also subject to account type, trading permissions, and market rules.

Security

Do not put private keys or authorization data in source code, logs, or version control. Regenerate keys or revoke access when an application is no longer used.

Setup guides


What’s Next

Did this page help you?